You are on page 1of 27

Section Navigator Pro By World is Welcome. http://www.worldiswelcome.com.

Section Navigator Pro


(A World is Welcome Creation)
(Written By: Ganesh Dutt Sharma)

(Version 1.5.06)
(Updated on: 21st Dec, 2008)

Shop at http://zenshop.worldiswelcome.com 1
Section Navigator Pro By World is Welcome. http://www.worldiswelcome.com.

S No Chapter Page
1 What is Section Navigator 3
2 Installing the component 4
3 Verifying the Installation 5
4 Using Section Navigator 6
5 Section Navigator Parameters ScreenShot 8
6 Introduction to Section Navigator Parameters 14
7 Introductory Example to Show Working of Section Navigator Pro 20

Shop at http://zenshop.worldiswelcome.com 2
Section Navigator Pro By World is Welcome. http://www.worldiswelcome.com.

What is Section Navigator


Section Navigator is a Native Joomla 1.5 extension, which helps the user to navigate through all the
sections of the website. While doing navigation, the administrator has full control of what to display
and what not in sections/categories/articles. Apart from this there are loads of other options at back-end
which make Section Navigator a unique choice.

Shop at http://zenshop.worldiswelcome.com 3
Section Navigator Pro By World is Welcome. http://www.worldiswelcome.com.

Installing the component


Here are the steps to installing the component:
1. Login to the admin panel.
2. Click on Extensions->Install/Uninstall. And You See as below:

3. Choose the desired file to install using Browse button.. E.g com_sectionnavigatorpro.zip. And
click on
Upload file & Install button..
4. After you finish the installation, you see the message “Install Component Success” message as
below:

Shop at http://zenshop.worldiswelcome.com 4
Section Navigator Pro By World is Welcome. http://www.worldiswelcome.com.

Verifying the Installation


Just point your mouse to “Components” in top menu and you see “sectionnavigatorpro” written in the
menu. This indicates that the component is installed. Further you click on that and you see basic
introduction to the Section Navigator. Just see the picture below:

Shop at http://zenshop.worldiswelcome.com 5
Section Navigator Pro By World is Welcome. http://www.worldiswelcome.com.

Using Section Navigator

The steps are as below:


1. Point mouse to the “Menus” item in top menu and click on your desired menu.

2. There you click on “New” button on the right side of top menu.

3. Then you are taken to “Select Menu Item Type”. Click on “sectionnavitatorpro” and then
click on “Default Layout” under “sectionnavigatorpro”. This is shown in below picture:

Shop at http://zenshop.worldiswelcome.com 6
Section Navigator Pro By World is Welcome. http://www.worldiswelcome.com.

4. After this you're taken back to the menu item naming. Name the menu item as of your liking.

5. Set the parameters as per your liking and you are done. Section Navigator is optimized to use
the default values. But you have full control over what you can do and what you can't.

Shop at http://zenshop.worldiswelcome.com 7
Section Navigator Pro By World is Welcome. http://www.worldiswelcome.com.

Section Navigator Parameters Screen Shots

Shop at http://zenshop.worldiswelcome.com 8
Section Navigator Pro By World is Welcome. http://www.worldiswelcome.com.

Shop at http://zenshop.worldiswelcome.com 9
Section Navigator Pro By World is Welcome. http://www.worldiswelcome.com.

Shop at http://zenshop.worldiswelcome.com 10
Section Navigator Pro By World is Welcome. http://www.worldiswelcome.com.

Shop at http://zenshop.worldiswelcome.com 11
Section Navigator Pro By World is Welcome. http://www.worldiswelcome.com.

Shop at http://zenshop.worldiswelcome.com 12
Section Navigator Pro By World is Welcome. http://www.worldiswelcome.com.

Shop at http://zenshop.worldiswelcome.com 13
Section Navigator Pro By World is Welcome. http://www.worldiswelcome.com.

Introduction to Section Navigator Parameters


Loads of parameters are available to control the operation of Section Navigator. Almost all of the
parameters are described below one by one in the following table.

S. Parameter Description
No.
1 Section Navigator Views The options are: Expanded Sections--->Cats--->Arts and Tabbed
Sections .
A. If you choose “Expanded Sections--->Cats--->Arts” option
then sections, categories and articles are expandable. Clicking on
sections presents categories. clicking on categories presents
Articles list. A plus sign is shown to click for expand and minus
sign for collapse. Initially all sections are collapsed. Expand all
and collapse all option is also presented on the top. If you want
then you can turn off the words “Expand” and “Collapse” etc.

B. If you choose “Tabbed Sections”, then all sections are


presented as tabs. Clicking on a particular tab shows categories of
that particular section. You can show all tabs at a time or n number
of tabs at a time.

2 Text to display before lists This is the text to be displayed before the sections list starts. Basic
HTML tags are applicable. e.g <br>, <strong> etc.
3 Show UnAuthorized Links Not in use at the moment. May be programmed later on if need be.
4 Number of Tabs At a Time If you leave this option blank then all sections will be taken as
to Show Sections(Blank tabs at a time. If you enter a number, then those number of tabs
Means All) will be shown at a time. Like say you have 30 sections and you
specify 3. Then three tabs at a time will be shown. And 10 similar
lines will be shown on the same page.
5 Number of Cols to Show This refers to the number of columns to show the sections in. The
Sections rows are adjusted automatically. Default is 2. You can experiment
with this number to suit the look and feel of your requirements.
6 Number of Cols to Show This refers to the number of columns to show the categories in.
Categories The rows are adjusted automatically. Default is 2. You can
experiment with this number to suit the look and feel of your
requirements.
7 Enter Section IDs to Enter comma separated section id values(integers) to include or
Include or Exclude. exclude. If you write positive values then all of those values will
Separate by comma. be included and rest of the sections will be excluded. + sign
Positive means include, should not be used with positive sections. If you write negative

Shop at http://zenshop.worldiswelcome.com 14
Section Navigator Pro By World is Welcome. http://www.worldiswelcome.com.

Negative means exclude. values then those sections will be excluded and rest all sections
(Blank Means Include All) will be included. Leaving blank defaults to include all sections. If
you put some positive and some negative values then the behavior
is decided with the first value. If its positive then all of the values
in the list are included. If its negative then all of the values in the
list are excluded.
8 Enter Category IDs to Enter comma separated category id values(integers) to include or
Include or Exclude. exclude. The good thing about this option is that for some
Separate by comma. sections you can include some categories and for some sections
Positive means include, you can exclude some categories as per your requirements.
Negative means exclude. If you write positive values then all of those values will be
(Blank Means Include All) included for that section and rest of the categories for that section
will be excluded. + sign should not be used with positive
categories. If you write negative values then those categories for a
section will be excluded and rest all categories for that section will
be included. Leaving blank defaults to include all categories. If
you put some positive and some negative values then the behavior
is decided with the first value. If its positive then all of the values
in the list are included. If its negative then all of the values in the
list are excluded.
9 Enter Article IDs to Enter comma separated article id values(integers) to include or
Include or Exclude. exclude. The good thing about this option is that for some
Separate by comma. sections and categories you can include some articles and for
Positive means include, some sections and categories you can exclude some articles as
Negative means exclude. per your requirements.
(Blank Means Include All) If you write positive values then all of those values will be
included for that section and category and rest of the articles for
that section and category will be excluded. + sign should not be
used with positive articles. If you write negative values then
those articles for a section and category will be excluded and rest
all articles for that section and category will be included. Leaving
blank defaults to include all articles. If you put some positive and
some negative values then the behavior is decided with the first
value. If its positive then all of the values in the list are included.
If its negative then all of the values in the list are excluded.
10 Show Empty Categories The options are Yes/No. If “Yes” then empty categories are
displayed.
11 Show Empty Sections The options are Yes/No. If “Yes” then empty sections are
displayed.
12 Show Category Count in The options are Yes/No. If “Yes” then categories in the sections
Section are displayed besides the section name.
13 Show Article Count in The options are Yes/No. If “Yes” then articles in the sections are

Shop at http://zenshop.worldiswelcome.com 15
Section Navigator Pro By World is Welcome. http://www.worldiswelcome.com.

Section displayed besides the section name.


14 Show Article Count in The options are Yes/No. If “Yes” then articles in the categories are
Category displayed besides the category name.
15 Section Layout Three layouts are available. Blog, list and articles list on separate
page. Articles list on separate page prints section articles on
separate page, instead of on same page and hence its efficient.
16 Category Layout Three layouts are available. Blog, list and articles list on separate
page. Articles list on separate page prints category articles on
separate page, instead of on same page and hence its efficient.
17 Show Articles List On The options are Yes/No. If you choose “Yes” option then articles
Separate Page are presented on separate page when you click on category. If you
choose “No” option then articles are printed on same page.
18 Number of Articles to If you choose option “Show Articles List on Separate Page”
Show Per Page then you can specify how many articles to show at a time per
page. Default is 10.
19 Turn Off Warnings? Only applicable for Section Navigator Multi Pro.
20 Turn Off Errors? Only applicable for Section Navigator Multi Pro.
21 Sections Order This option presents the sorting of sections. The available values
are: Alphabetical, Reverse Alphabetical and Ordering(In which
sections were created.)
22 Categories Order This option presents the sorting of categories under sections. The
available values are: Alphabetical, Reverse Alphabetical and
Ordering(In which categories were created.)
23 Articles Order This option presents the sorting of articles under categories under
sections. The available values are: Alphabetical, Reverse
Alphabetical and Ordering(In which articles were created.),
Newest First, Oldest First, Newest First Modified, Oldest First
Modified, Least Hits, Most Hits, Author, Reverse Author Name.
24 Expand Sections Initially? The possible values are Yes/No. The option is applicable to
'Expanded Sections--->Cats--->Arts'. If set to Yes all of the
section/categories and articles are expanded.
25 Show Expand/Collapse In 'Expanded Sections--->Cats--->Arts' view you see the words,
Text? 'EXPAND ALL', 'EXPAND', 'COLLAPSE ALL',
'COLLAPSE'. If set to yes, then these words will be shown, else
only plus sign will be displayed. By default the option is 'Yes'.
26 Text to display after lists This is the text you wanna display after the section list is ended.
27 Articles display related These are self evident.
parameters

Shop at http://zenshop.worldiswelcome.com 16
Section Navigator Pro By World is Welcome. http://www.worldiswelcome.com.

28 Blog Related Parameters These are self evident.


29 SEF URL Components This option presents the components of URL.
There are three options:
1. Only Article portion will be shown in URL as appropriate.

When this is turned on then in URL structure, section and category


portions are excluded. Only article portion is included. e.g
http://articles.worldiswelcome.com/section-
navigator/article/customer-service/hawaii-gourmet-
shopping.html

2. /Category/Articles will be shown in URL as appropriate.

When this option is turned on then in URL structure category and


article portions are included. e.g
http://articles.worldiswelcome.com/section-
navigator/article/beauty/spa-facial-treatments-can-be-done-at-
home.html

3. /Section/Category/Articles will be shown in URL as


appropriate.

When this option is turned on then in URL structure section,


category and article portions are included. e.g
http://articles.worldiswelcome.com/section-
navigator/article/business/marketing/5-simple-rules-to-get-rich-
fast.html

30 URLs Look Like Here there are three choices for the user. How should the URL
look like.
1. /id-Section-Title/id-Category-Title/idArticle-Title
With this option turned on the URL components will have title and
id slug e.g as below:
http://articles.worldiswelcome.com/section-navigator/article/6-
business/61-careers/2578-a-successful-interview.html
2. /Section-Title/Category-Title/Article-Title
With this option turned on the URL components will have title
only e.g as below:
http://articles.worldiswelcome.com/sectionnavigator/
article/business/careers/a-successful-interview.html
3. /Section-id/Category-id/Article-id
4. With this option turned on the URL components will
have IDs

Shop at http://zenshop.worldiswelcome.com 17
Section Navigator Pro By World is Welcome. http://www.worldiswelcome.com.

only e.g as below:


http://articles.worldiswelcome.com/sectionnavigator/
article/6/61/2578.html
31 Section Font Related These are self evident options for section font styling. You can
Parameters. specify font family, size, weight, color and style.
32 Category Font Related These are self evident options for category font styling. You can
Parameters. specify font family, size, weight, color and style.
33 Article Font Related These are self evident options for article font styling. You can
Parameters. specify font family, size, weight, color and style.

ADVANCED PARAMETERS
1 Description To show description for Section or Category in blog view.
2 Treat Section With Empty This is special option. This option refers to blank sections. Let's
Category As Empty? say some section is having zero articles and 5 categories. All of
the categories under that section are also empty. Now, its upto the
user whether she wants to assume that section as empty or not. If
'Yes' then that section with empty categories will be taken as
empty and normal empty sections rules will be applied on that.
If 'No' then this section will be printed, even though you may have
set the option “Show Blank Sections” to 'No', because now this
section will not be empty.
3 Description Image To show description image for the section or category or not. This
option applies to blog view.
4 Ads to display before title This option prints ad before article's title. Here in text box you can
of article paste the publisher advertisement code provided by google
adsense, chitika, adbrite etc. to show advertisements in your
articles. How may ads to show is upto the user.
5 Ads to display after title of This option prints ad after article's title. Here in text box you can
article paste the publisher advertisement code provided by google
adsense, chitika, adbrite etc. to show advertisements in your
articles. How may ads to show is upto the user.
6 Ads to display at bottom of This option prints ad at the bottom of article. Here in text box you
content of article can paste the publisher advertisement code provided by google
adsense, chitika, adbrite etc. to show advertisements in your
articles. How may ads to show is upto the user.
7 Ads to display at end of This option prints ad article printing is finished. Here in text box
content of article you can paste the publisher advertisement code provided by
google adsense, chitika, adbrite etc. to show advertisements in
your articles. How may ads to show is upto the user.

Shop at http://zenshop.worldiswelcome.com 18
Section Navigator Pro By World is Welcome. http://www.worldiswelcome.com.

8 Show Boundary Line Two options are available. If you want to see the boundary line
around the sections, then set it to Yes. Else No.
9 Show Powered By Link This also has two options. If you keep it to Yes, then it will show
the link: 'Powered By: Section Navigator Pro'. We recommend
that you let it be there. Or you can cancel it out. Simply press No.
10 More options are on the Let's see which options users demand.
way.

Shop at http://zenshop.worldiswelcome.com 19
Section Navigator Pro By World is Welcome. http://www.worldiswelcome.com.

Introductory Example to Show The Working of Section Navigator Pro

For introducing the working of Section Navigator, I am taking the examples as below. These will serve
as the sample data. This will also highlight the intricacies of the Section Navigator. Also it will help
you to set it up as per your needs.

1. Sections/Categories/Articles Considered are as per below table:

Sec Sec Name Cat Id Cat Name Art Id Article Title


Id
4 Health&Fitness 117 Alternative 3466 5 Indicators That You Have Bronchitis
Medicine
4 Health&Fitness 118 Beauty 3179 Spa Facial Treatments can be Done at
Home
4 Health&Fitness 119 Cardio 2635 High LDL Cholesterol Levels and Health
Risks
4 Health&Fitness 120 Depression 3427 Depression is Painful
6 Business 59 Advertising 4197 Cross Promote Online For Maximum
Profits
6 Business 63 Enterpreneurs
6 Business 65 Home Based 4024 Top Seven Things to Look for When
Business Choosing an MLM Opportunity
6 Business 65 Home Based 3980 Top Seven Things to Look for When
Business Choosing an MLM Opportunity One way
to check what goes on while you are gone
is Nanny Cam's.
6 Business 66 Management
17 Disease&Illness 85 Breast Cancer 1974 Treatments For Metastatic Breast Cancer
17 Disease&Illness 88 Mesothelioma
17 Disease&Illness 91 Prostate
Cancer

2. Now Let's consider the following scenario.

For Sections, we want to include sections Health&Fitness, Business and Diseases&Illness.

For Categories we want to include: Alternative Medicine, Beauty, Cardio, Depression,

Shop at http://zenshop.worldiswelcome.com 20
Section Navigator Pro By World is Welcome. http://www.worldiswelcome.com.

Breast Cancer, Mesothelioma, Prostate Cancer categories from sections Health&Fitness


and Diseases&Illness.

For Categories we want to exclude: Advertising, Enterpreneurs, Home Based Business,


Management from section Business.

For Articles we want to include:5 Indicators That You Have Bronchitis, Spa Facial Treatments
can be Done at Home, Treatments For Metastatic Breast Cancer.
For Articles we want to exclude:High LDL Cholesterol Levels and Health Risks, Depression is
Painful, Cross Promote Online For Maximum Profits, Top Seven Things to Look for When
Choosing an MLM Opportunity, Top Seven Things to Look for When Choosing an MLM
Opportunity One way to check what goes on while you are gone is Nanny Cam's.

3. Our Section Navigator allows us to include or exclude any sections, categories or articles.

4. You can either include a set of sections or exclude it. You can't include or exclude sections at
the same time.(Not a possible scenario).

5. You can include categories for some sections and exclude categories from some other sections.

6. You can include articles for some sections/categories and exclude articles from some other
sections/categories.

7. To include sections simply provide a comma separated list of Ids. To exclude sections simply
provide a comma separated list of negative Ids. Negative is considered as exclusion.

8. To include categories simply provide a comma separated list of Ids. To exclude sections simply
provide a comma separated list of negative Ids. Negative is considered as exclusion.

9. To include categories simply provide a comma separated list of Ids. To exclude sections simply
provide a comma separated list of negative Ids. Negative is considered as exclusion.

10. For our present scenario, Sections will be mentioned as: 4,6,17. That means include only 4, 6
and 17 no. sections rest will not be considered. If you give -4,-6,-17 then these will be excluded
and rest all of the sections will be included.

11. For our present scenario, Categories will be mentioned as:


117,118,119,120,85,88,91,-59,-63,-65,-66. That means include only 117,118,119,120,85,88 and
91 no. categories rest will not be considered for those sections 4 and 17. Categories -59,-63,-65
and -66 mean that these category Ids will be excluded from the list and rest all will be included
for the section 6.

12. For our present scenario, Articles will be mentioned as:


3466,3179,1974,-2635,-3427,-4197,-4024,-3980. That means include only 3466,3179 and 1974.
Rest of the articles in that particular section/categories (4:::117,118) and (17:::85) will not be

Shop at http://zenshop.worldiswelcome.com 21
Section Navigator Pro By World is Welcome. http://www.worldiswelcome.com.

included. Articles -2635,-3427,-4197,-4024 and -3980 mean that these will be excluded from
the list for those particular Section/Category Sets as (4:::119,120) and (6:::59,65).

13. The parameters sheet has been filled as per screen shots given above.

Let's observe the result. First I show the screen shot without excluding anything:

Business: Categories=13, Articles=516


Health&Fitness: Categories=21, Articles=417
Diseases&Illness: Categories=11, Articles=79

Shop at http://zenshop.worldiswelcome.com 22
Section Navigator Pro By World is Welcome. http://www.worldiswelcome.com.

Shop at http://zenshop.worldiswelcome.com 23
Section Navigator Pro By World is Welcome. http://www.worldiswelcome.com.

Now, let's fill only section values in the parameters and see what we see.

Now, let's fill categories next but not articles. Let's see what happens.

Shop at http://zenshop.worldiswelcome.com 24
Section Navigator Pro By World is Welcome. http://www.worldiswelcome.com.

Business: Categories=9, Articles=254


Health&Fitness: Categories=4, Articles=85
Diseases&Illness: Categories=3, Articles=112

After paying attention, we come to know that we wanted. Business has now only 9 categories. 4 have
been excluded. Health&Fitness and Diseases&Illness have 4 and 3 categories resp.

Shop at http://zenshop.worldiswelcome.com 25
Section Navigator Pro By World is Welcome. http://www.worldiswelcome.com.

Now, let's fill out articles list as well and see what happens.

Business: Categories=9, Articles=254


Health&Fitness: Categories=4, Articles=5
Diseases&Illness: Categories=3, Articles=3

After paying attention, we come to know that we wanted. Business has now only 9 categories and full
articles because we specified nothing for Business Section.. 4 categories have been excluded.

Shop at http://zenshop.worldiswelcome.com 26
Section Navigator Pro By World is Welcome. http://www.worldiswelcome.com.

Health&Fitness has now 5 articles because of inclusion and exclusion coming in effect. Rounded boxes
tell the story of inclusion. Diseases&Illness has 3 articles. We specified nothing for Mesothelioma, that
means include all. But its empty. No article is there. Still it was shown due to the option: “Show empty
categories=Yes.

If this documentation can serves your purpose, that's the greatest achievement for me.

Shop at http://zenshop.worldiswelcome.com 27