Adding a menu item which points to an Article
From Joomla! Documentation
Revision as of 22:07, 22 June 2018 by AlexSmirnov (Hey, there :) This doc concerns creating a new menu, when the Save & Copy button doesn't show: "This toolbar icon is not shown if you are creating a new menu item." Hence my suggeston to remove this part. My 2c. Cheers!)
The following tutorial will show you how to create a new item in the main menu that points to the article called Support and Documentation. Based on this information you will be able to add a new menu item to any of your defined menus pointing to any article you have previously created for your site.
If you are not currently logged into the administration panel, you will need to do so. If you are already logged in, you do not need to complete this step.
1. Open a new browser window and type in the URL, which will be similar to
http://www.your-site-name-here.com/administrator or, if you have Joomla! installed on your local computer,
http://localhost/your-folder-name-here/administrator. Here you will have to log in as an Administrator or Super Administrator.
2. Within the site administration panel, select Menus from the menu bar in the upper left corner. From the drop-down list, choose the menu you wish to work with. The menu can be Main Menu, available by default, or any other menu. This will open the Menu Item Manager page. You can also select Menu Manager from the left column and then select the menu you need from the list provided.
3. In the toolbar, at the upper-left corner, select New (represented by the green icon with the plus sign). This will open the Menu Item: [New] page.
4. From the Menu Item Page click on the Select list for Menu Item Type.
5. From the list displayed, choose Articles.
6. Choose Single Article in the previously expanded Articles section.
7. Returning to the Menu Item Page, click on the Select list for the Select Article field.
8. A list of your Articles will pop up. Select an article by clicking on its title. You can narrow your search if you have a lot of articles by using the dropdown tools at the top of the screen.
We are getting really close. Hold on!
On the new page fill in the different fields as listed below. Note that the "Required" fields are indicated by an asterisk(*) next to the label.
Menu Item Details
- Menu Title
This will be the text displayed for the newly added menu item. For this particular case let's use the word Sample. Note: "Menu Title" is a required field.
Usually, you will leave this empty and Joomla! will fill this in for you automatically. The content of this field will determine the page URL when SEF is activated.
- Menu Location
This should already be set to Main Menu (or the menu you have previously chosen). Here you have the possibility to move the item to another menu if you wish. This field is quite useful when you decide to change the item location later. Note: "Menu Location" is a required field.
- Parent Item
Here you can specify where to place the new menu item. You can make it the Menu Item Root (top item) or a sub-item of an already existing item. We will choose Menu Item Root.
If you wish your new item to be shown on your site, set this to Published. If you would like to make this menu item invisible from the site, simply set this to Unpublished. It will not delete the item but will make it invisible to your visitors. If you would like to remove this menu item from the site, simply set this to Trashed. It will not delete the item but will put it in the Trash, from this you can delete it.
Click on the Save button at the top of the page and the Ordering drop-down will be visible. The new menu item will default to the bottom of the list, but you can change that by selecting the "First", "Last" or another menu item in the list to change its position.
- Default Page You can select this option if you'd like this menu item to be your Home Page.
- Access Level
This option will specify who will be able to see this new menu item:
- Public - All visitors
- Registered - Registered users only
- Special - users assigned to any group besides "Registered"
- Target Window
Here you can specify how to open the article. It can be the same browser window (Parent Window with Browser Navigation), a new browser window (New Window with Browser navigation) or a pop-up window (New Window without Browser Navigation)
- Template Style - Select a specific template for this menu item, or leave as 'Use default' for the default template.
- Language - Select a specific language or leave the default "All".
Now, let's click on the Options tab at the top of the page. Here are more options you can choose for the display of your menu item. If you decide to explore all your options, you will find good help in the tool tips that appear when you move your mouse over the labels.
Note that these options include "Use Global". If this is selected, the setting from the Article Manager Options will be used.
- Show Title - (Use Global/Hide/Show). Whether or not to show the Article's Title.
- Linked Titles - (Use Global/No/Yes). If the Article's Title is shown, whether to show it as a link to the article.
- Show Intro Text - (Use Global/Hide/Show). If set to Show, the Intro Text of the article will show when you drill down to the article - If set to Hide, only the part of the article after the "Read More" break will show.
- Position of Article Info - (Use Global/Above/Below/Split). Position of Article Info. Puts the article information block above or below the text or splits it into two separate blocks. One block is above and the other is below.
- Show Category - (Use Global/Hide/Show). Whether or not to show the Article's Category.
- Link Category - (Use Global/No/Yes). If the Article's Category is shown, whether to show it as a link to a Category layout - (list or blog) for that Category.
- Show Parent - (Use Global/Hide/Show). Whether or not to show the Article's Parent Category.
- Link Parent - (Use Global/No/Yes). If the Article's Parent Category is shown, whether to show it as a link to a Category layout - (list or blog) for that Category.
- Show Author - (Use Global/Hide/Show) Whether to show the author of the Article.
- Link Author - (Use Global/No/Yes). If the Article's author is shown, whether to show it as a link to a Contact layout for that author. Note that the author must be set up as a Contact in Contact Manager → Edit.
- Show Create Date - (Use Global/Hide/Show). Whether or not to show the Article's create date.
- Show Modify Date - (Use Global/Hide/Show). Whether or not to show the Article's modify date.
- Show Publish Date - (Use Global/Hide/Show). Whether or not to show the Article's start publishing date.
- Show Navigation - (Use Global/Hide/Show). Whether or not to show a navigation link (for example, Next or Previous article) when you drill down to the article.
- Show Voting - (Use Global/Hide/Show). Whether or not to show the a voting icon for the article.
- Show Icons - (Use Global/Hide/Show). If set to Show, Print and Email will use icons instead of text.
- Show Print Icon - (Use Global/Hide/Show). Show or Hide the Print Article button.
- Show Email Icon - (Use Global/Hide/Show). Show or Hide the Email Article button.
- Show Hits - (Use Global/Hide/Show). Show or Hide the number of times the article has been hit (displayed by a user).
- Show Tags - (Use Global/Hide/Show). Show or Hide the Tags.
- Show Unauthorised Links - (Use Global/No/Yes). If Yes, the Intro Text for restricted articles will show. Clicking on the "Read More" link will require users to log in to view the full article content.
- Positioning of the Links - (Use Global/Above/Below). If Above, links are shown above the content. Otherwise they are shown below the content.
Link Types Tab
Click on the tab labeled Link Types. This section will let you customize the way the page containing the article will be displayed. If you decide to explore all your options, you will find good help in the tool tips that appear when you move your mouse over the labels.
- Link Title Attribute - An optional, custom description for the title attribute of the menu hyperlink.
- Link CSS Style - An optional, custom style to apply to the menu hyperlink.
- Link Image - An optional image to be used with the menu hyperlink. The image you would like to associate with the item must be stored in the images/ folder. You can upload your own image using the Media Manager or by FTP.
- Add Menu Title - (Yes/No). If the optional image is added, adds the menu title next to the image. Default is 'Yes'.
Page Display Tab
- Browser Page Title - If this parameter is left blank, Joomla! will generate a Browser Page Title automatically. This can be used to override the page title set in the article. Don't forget that page titles are one of the most important points when it comes to search engine optimization (SEO)! Use them wisely.
- Show Page Heading - Display (Use Global/Yes/No) the page title set in the previous parameter.
- Page Heading - Optional alternative text for the Page heading.
- Page Class - This allows you to generate unique CSS classes for this page. This comes in useful when you would like to change the look of the page to differentiate it from the rest of the site. If you don't need this, simply leave the field empty.
Click on the tab labeled Metadata. This is where you can customize your meta tags for SEO optimization. You will find good help in the tool tips that appear when you move your mouse over the labels.
- Meta Description - An optional paragraph to be used as the description of the page in the HTML output. This will generally display in the results of search engines.
- Meta Keywords - An optional comma-separated list of keywords and/or phrases to be used in the HTML output.
- Robots - (Use Global/Index, Follow/No index, follow/Index, No follow/No index, no follow). Robots Instructions
This is for specifying the SSL security for your page:
- On - As a secure page
- Off - As a standard page
- Ignore - Displayed as the other pages - secure or not.
Module Assignment Tab
Click on the tab labeled Module Assignment. In this area, you can make adjustments to modules. Please see this link for specific information on the options available in the Module area. Extensions Module Manager Menu
Once you are done, click the Save button in the upper-left corner. This will save your work. This will save the new item and place it as the last element (or sub-element, in case of sub-menu items) in the menu. After the first save you can change the item order position within the menu. The Save and Close button options are described below the image.
- Save - Saves the menu item and stays in the current screen.
- Save & Close - Saves the menu item and closes the current screen.
- Save & New - Saves the menu item and keeps the editing screen open and ready to create another menu item.
- Close - Closes the current screen and returns to the previous screen without saving any modifications you may have made.
Now, go back to the front-end and refresh the page. You should be able to see your new menu item.
Please note that you might need to log in as a registered user or administrator to view the new item. It all depends on the Access Level you have set (see above). When you click the new item, the article will be opened.