Posted on: Jun 17, 2016

Menu Settings

Understanding how menus are working

It is important to understand how menus are working. You can take any CSS/HTML menu and convert it to dynamic using the relevant tpl files. It's quiet easy and powerful but that will be discussed on templates section. In this page you will get an idea how menus are working which is vital to understand as mentioned before.
There are a few constraints to been able to create a menu. The first is that you need to setup previously a language as each menu must associated with a language.

The second constraint is categories and or subcategories. You must have some of them to allow you to create a menu and optional a few articles on each.
There is also an extra way to add non-existing content by linking any url to the menu. That called in Guru CMS "Add link to the menu as Category"

A screen cast is also available here.

Create menu

In order to set up the menu of your site you need first to have set up the languages, categories/subcategories and articles as mentioned earlier.

The first step is to select the language of the menu. This gives you the functionality to have different menus based on the language.
The languages that will be listed are the ones that you have enabled from the language settings.
At a first glance you can see the menus that have been created. The names of the menus have been set automatically based on the language of it.

In order to create a menu you just have to select a new language from the drop down list and then press the "Create menu" button.
After that, you can view the result of your actions:

At this point the menu for the language has been created already. In order to customize the specific menu please click on the link for this language. It will display the number of existing categories in our content available for publishing. The first screenshot below shows a menu with no categories/content at all while the second one taken from a live web site with the whole structure properly set.

These categories will be accompanied by a 'Publish' link which is in use if you want to publish it and an 'Unpublish' link which is in use if the category has been published in the past and now you want to unpublish it. Moreover, the categories names are links in order to view the available subcategories of it. See screenshots below:

Please note that it is not vital to publish all the categories that exist in your content.
A rule of thumb is to check the layout in the front page every time that you publish a new category in order to see if the layout remains appropriate.

The next step is to publish the categories and subcategories that we want to be displayed in the site's menu.
In our case (see left screenshot above) we have only one category unpublished and that is "General".

If you want to publish the category then please click on the 'Publish' link.
Moreover, in the case that you have many categories you can click on the checkbox near the 'Name' tab and then press on the 'Publish all' button. This will publish all the categories.
Note that now the 'Actions' link has been changed from Publish to Unpublish.

Furthermore, in the case that you click the 'Unpublish all' or 'Publish all' button and did not select the initial checkbox an error message will be displayed for informing you that you have to make this selection first and then proceed with your alterations.

If you click on the category name, you can view the available subcategories and publish/unpublish them.

With the same idea you can publish/unpublish subcategories.
After finishing your alterations the menu has been created automatically and you can view it by visiting your website's home page.
At any point you like, you can change your menu's settings by editing the menu that you just created by clicking on the menu name in the main page of "Menu Settings".

You can browse your public web site any time while been still on the administration menu by simply opening a new tab while clicking the "Public Home" link from the administration menu appear on the top of it.

Delete menu

If you want to delete the menu then just press the 'Delete' link besides the specific menu name.
Please note that will automatically affect your home's page layout.
A confirmation prompt window will be generated in order to ensure your actions.

When you delete a menu all content will remain untouched. It is simply deletes the menu entries.

Edit menu

In order to edit an existing menu then first please click on the menu name of it.
This will redirect you to a list of published categories where you can delete the existing categories, a link 'Publish more Categories' where you can publish new categories and a link 'Add link to the menu as Category'.
The 'Add link to the menu as Category' is in use whenever you want to add an external or internal link to your menu as category.
A prompt window is generating where you have to fill in the 'Display name' and the 'External link' of it. Please note that at that point you can enter an article in your menu or any other file you like by knowing the full path of it.

By pressing the 'Submit link' button your changes will be saved.
The category is automatically been published. The same idea works for the subcategories also.
By clicking on the Move Up or Move Down button you can re-order the categories in order to customize the view of your menu in the front-end.
Moreover, at this point you can view if you have or not unpublished categories in order to avoid performing another step for this.