https://www.icyphoenix.com/viewtopic.php?f=4&t=4891
-----------------------------------
Chaotic
Mon 13 Oct, 2008 18:48

CMS - Icy Phoenix CMS Guide
-----------------------------------
[b][size=18]Icy Phoenix Portal Guide[/size][/b]
[img align=right]http://www.icyphoenix.com/files/images/3295/portal.png[/img] 

In this guide, we'll discuss:

[list=1][*][url=#first_chapter]The CMS menu.
[*][url=#second_chapter]How to create/delete/edit blocks in your portal. 
[*][url=#third_chapter]How to set page permissions in your portal.
[*][url=#fourth_chapter]How to create new pages in your portal.
[*][url=#fifth_chapter]How to switch from the [b]nav links [Sitemap][/b] block to [b]dyn menu [Dynamic Menu][/b] block.
[*][url=#sixth_chapter]How to create/delete/edit links in your dynamic menu.[/list]

[hr]
[list=1][*][b][url href=#first_chapter name=first_chapter]Quick Look At The CMS Menu[/b]
 [img align=right]http://www.icyphoenix.com/files/images/3295/cmsmenu.png[/img]

[list][*][u]Home[/u] - Home page of your portal.
[*][u]ACP[/u] - (Administration Control Panel) This is the core of your Icy Phoenix.  You'll find many different settings that will allow you to fully customize your website the way you like.
[*][u]Manage CMS[/u] - Manage all your Icy Phoenix and customized pages here.
[*][u]Configure CMS[/u] - Chose your default site page and control the width of both left and right columns.
[*][u]Dynamic Menu[/u] - Create a menu with the links you like.
[*][u]Page Permissions[/u] - Who can see each page of your website?  Everyone, guests, registered members, moderators, administrators?[/list]




Now let's look into managing our Icy Phoenix and customized pages by clicking the [b]Manage CMS[/b] icon.
[hr]
 [img align=right]http://www.icyphoenix.com/files/images/3295/pages.png[/img]  
[b]Manage CMS[/b]

From this menu, you will be able to manage all the pages in your Icy Phoenix as well as the customized pages you create.  You are also able to edit the standard pages to add or remove blocks.

Notice you are not able to delete [u]Standard Pages[/u] in this control panel.

Let's start with the first [u]Global Blocks[/u] section and create a new Global Block.
[hr]
 [img align=right]http://www.icyphoenix.com/files/images/3295/globalblock.png[/img] 

From this menu, you are able to do a variety of customizations.  You'll notice:

[list][*]green and red arrows that allow you to move a certain block up or down.  This is useful if you want a certain block to show above or below another block.
[*]edit and delete buttons that will allow you to edit or delete the specific block.
[*]the status box that shows if the block is active or not.[/list]
With a quick glance, you'll see where your block is positioned, the contents, and the permission level.  Let's [b]create a new block[/b].
[hr]
 [img align=right]http://www.icyphoenix.com/files/images/3295/blockedit.png[/img] 
[*][b][url href=#second_chapter name=second_chapter]How To Create/Edit/Delete A Block[/b]

Several fields require your attention in order to successfully create a new block.  Title your new block something unique that won't be confused with the blocks you create in the future.  Think of where you want to place the new block and choose between:
[list][*]Page header
[*]Left
[*]Top/Center
[*]Bottom/Center
[*]Right
[*]Page footer[/list]
Decide if you would like the block to be active by ticking the check box in the [u]status[/u] line.  There are many options of different block types to choose from.  For example, you may want this block to display the calendar, polls, online users, forum statistics, recent topics, etc.  There is also a block file that allows you to add your own customized text/HTML.  Select the [u]Block File[/u] you would like to use.  It is possible to create blocks only certain usergroups can see.

 [img align=right]http://www.icyphoenix.com/files/images/3295/borderstitlebars_1222935952_143850.png[/img] 

By selecting [i]Guests Only[/i] in the [u]View By[/u] options, only guests will see this block.  
Selecting the Registered Users option will make this block viewable by registered members and not guests.  
The permissions get more strict as you select [i]Moderators[/i] and [i]Administrators[/i].  
If the block is intended to be seen by everyone, select [i]All[/i].

The next few options are for [u]Showing The Border[/u] and [u]Showing The Titlebar[/u].  It's best to look at the pictures to understand what these two options are all about.

When [u]Localize Titlebar[/u] is enabled, the portal engine will not display the Titlebar text (assuming the Show Titlebar is enabled) from the [u]Block Title[/u] field.  Instead, it will look at the language file included with the block in the directory: /language/xxxxx, where xxxxx is the forum language.  The retrieved Titlebar text will be from the variable $lang['Title_yyyyy'] where yyyyy is the name of the block.

Select the usergroup that should see this block.  You'll see different usergroup names depending on your setup.  [u]Editing[/u] a block works almost the same way except a lot of the work has already been done by you.  By clicking the Edit option, you can edit everything just as if you were creating a new block!  Don't forget to click Submit at the bottom to make sure your changes are saved.  [u]Deleting[/u] a block is as easy as clicking the Delete button on the Blocks Management screen.
[hr]
 [img align=right]http://www.icyphoenix.com/files/images/3295/page_permissions_1223579650_741501.png[/img] 
[*][b][url href=#third_chapter name=third_chapter]How To Set Page Permissions[/b]

[u]Setting page permissions[/u] is really easy and helpful in many ways.  From this screen, you are able to decide who will see the listed pages.  You can select ALL, REG, MOD, or ADMIN.  You can also choose if you want the global blocks to be shown or not.
[hr]
[*][b][url href=#fourth_chapter name=fourth_chapter]How To Create New Pages[/b]
 [img align=right]http://www.icyphoenix.com/files/images/3295/create_new_page.png[/img] 

After heading back to the CMS Management page, click [u]Add Site Page[/u] at the bottom.  The details at the top of this screen explain:

[quote]From this control panel, you can add, edit or delete layout information for your site pages. Multiple site pages can use the same layout. The layout template file selected must reside in the layout directory under your forum template directory. You are not allowed to delete the default site page. Deleting a site page also deletes the corresponding block positions for that page and all the blocks assigned to it. You can also edit the blocks assigned to each page and create new pages from scratch even with a new physical name (if your server allows it you can create for example a new page called [b]mypage.php[/b]).[/quote] [img align=right]http://www.icyphoenix.com/files/images/3295/edit_site_page.png[/img] 

Give your new page a unique [u]Name[/u] so you'll be able to find it easier the next time you need to edit or delete it.  When naming the [u]Filename[/u], be sure to add .php after the title.  Ex: [i]testpage.php, cocacola.php, omglolhaha.php[/i].

You may run into a problem if this is displayed under the [u]Filename[/u] field.  Here is the problem and solution:

[quote]After a quick test it seems that your server DOES NOT ALLOW automatic files creation on your root. If you want to create a new page with a new physical name you should manually create the file on the server by duplicating index_empty.php and renaming it according to name you have chosen here. Alternatively you may assign the correct permissions to the root of your site so the procedure may run automatically.[/quote]

This may happen if you didn't CHMOD the correct folders/files when installing Icy Phoenix.  Solve this for future page creations by reviewing the Icy Phoenix Installation Guide for the correct folders/files to CHMOD.

Enabling [u]Site-Wide Blocks[/u] will display all global blocks on this new page.  Disabling [u]Site-Wide Blocks[/u] will display a clean page with no blocks.  You will be able to add blocks to this page after you finish the new page.  Just like before when creating a new block, [u]Permissions[/u] must be set for this page.  The default permission for any new page is ALL.  Choose from ALL, Guests Only, Registered Members, Moderators, and Administrators.  Now decide who has [u]Edit Permissions[/u]: Publisher, Reviewer, or Content Manager.  Publisher is selected by default.  You can also select custom usergroups that may view this new page.  When you are finished making the changes, click Submit at the bottom and you should see this box:


 [img align=right]http://www.icyphoenix.com/files/images/3295/page_created.png[/img] 
[hr]
[*][url href=#fifth_chapter name=fifth_chapter]How to switch from the [b]nav links [Sitemap][/b] block to [b]dyn menu [Dynamic Menu][/b] block.
 [img align=right]http://www.icyphoenix.com/files/images/3295/2column.png[/img] 
If you are as lazy as I am and don't want to keep going back to a file to add/edit/remove links, here is how you can change all that by using the [b]dyn menu [Dynamic Menu][/b] instead of the [b]nav links [Nav Links][/b] block.  You'll save yourself time and future heartache by taking a few minutes to make the change!

You should already have a dynamic menu ready to go by default upon Icy Phoenix installation.  It's up to you to enable it and use it.

Let's start by changing our menu on the index (home) page.  Go into your CMS menu (cms.php).  Find the Customized Pages section in the last half of this page.  Look for the page link that is similar to the picture up above.  Click the "configure blocks" icon.  Find your menu block (nav links, menu, etc.).  Click the edit button.

Change your block file from [b]nav links [Sitemap][/b] to [b]dyn menu [Dynamic Menu][/b].  (Keep in mind I am using CMS ADV on this test board, so things may look a little different here than on your board.  Just remember to make sure there are no borders, titles, or background checked.)  Click submit.

 [img align=right]http://www.icyphoenix.com/files/images/3295/blockedit_1233610522_584740.png[/img] 

You'll be asked for your menu block ID.  By default, Icy Phoenix has created a menu for you already.  The ID number should be 1.  The show/hide switch should be pretty explanatory.  Click submit.  You have now finished adding your new menu to your home page!  Let's do the same exact thing in our global blocks!

 [img align=right]http://www.icyphoenix.com/files/images/3295/global.png[/img] 

Going back to the main CMS page (cms.php), click the "configure blocks" icon next to the Global Blocks text.  Find your menu block (nav links, menu, etc.).  Click the edit button.  Now follow all the steps above on how to set it up.  It's the exact same method.  Congratulations!  You have switched the menu!

Now that you have changed to the dyn menu [Dynamic Menu] block, you can easily add/edit/delete links in the blink of an eye!

Follow the next step in the guide to add/edit/delete links in your new menu!
[hr]
[*][b][url href=#sixth_chapter name=sixth_chapter]How To Create/Edit/Delete Links In A Dynamic Menu[/b]
[img align=right]http://www.icyphoenix.com/files/images/3295/create_dyn_menu.png[/img]

A dynamic menu is a menu of links that you choose to show to your users.  The difference between a dynamic menu and using the SiteMap [nav_links] is a SiteMap includes ALL links to the various pages in your Icy Phoenix by default.  You can, however, edit this SiteMap to include only the links you want by editing [i]your-theme/nav_quick_links.tpl[/i].  

This menu should already have a default dynamic menu created.  You have the choice of editing this default dynamic menu or creating a new dynamic menu.  To create a new dynamic menu, click [u]Create A New Menu Block[/u] at the bottom of the Dynamic Menu screen.

Giving the new Dynamic Menu a unique [u]Menu Name[/u] helps to differentiate between all the possible menus you may create.  The [u]Language Var[/u] can be changed in the drop down menu to title the menu for you.  If you'd like to just use the [u]Menu Name[/u] you created, leave the default No Lang Var (use the specified name) option as is.  There is an option to type in a description of the menu you are creating.  When finished here, click Submit.  The new Dynamic Menu should show on the next screen:
 [img align=right]http://www.icyphoenix.com/files/images/3295/new_dyn_menu.png[/img] 
Now the new Dynamic Menu needs some categories and links.  The new menu that was created should show below the Main Links menu and is boxed in red in the picture to the right.  Click Edit next to the new Dynamic Menu.  The following screen should now show:
 [img align=right]http://www.icyphoenix.com/files/images/3295/nocategorydynmenu.png[/img] 
Categories are needed to house the links created for the menu.  To create a new category, click Create A New Category.  A new screen will show more fields for us to enter information into.


 [img align=right]http://www.icyphoenix.com/files/images/3295/newcatdynmenu.png[/img] 
The [u]Name[/u] of the new category can be anything.  Take a look around other websites that use Icy Phoenix as their CMS solution to get a better understanding of how to categorize your dynamic menu.  The name I've assigned to this test category is MENU.  Next, choose which [u]Language Var[/u] you would like to use.  As before when creating the new dynamic menu, you can leave this set to the default setting of: No Lang Var (use the specified name) to use the [u]Name[/u] of the category instead.  Set the [u]Status[/u] of the category to enabled if the category is intended to be seen by everyone; disabled if the category should not be active.  Select an [u]Icon[/u] for this category or use the Standard Icon option to show the default template icon for the category.  Add more icons to your liking by uploading the new icons to [i]/images/menu/[/i] or specify a URL to the icon in the empty field below the drop down menu.

Entering a unique [u]Category Description[/u] is useful when glancing through many created dynamic menus as you don't have to sift through menus with descriptions that look alike.  Lastly, decide who can see this category by selecting the [u]Permission[/u]: All, Guests Only, Registered Members, Moderators, or Administrators.  When finished with all these settings, click Submit.  Repeat this process until you have created all the categories you'll need for your dynamic menu.

 [img align=right]http://www.icyphoenix.com/files/images/3295/newlinkdynmenu.png[/img] 





Now to [u]Create A New Link[/u] in the dynamic menu.  Click Create A New Link in the Dynamic Menu screen.



[u]Choose the Category[/u] in the drop down box the new link should be listed under.  Again, be as descriptive as possible when typing in the [u]Link Name[/u].  By now, selecting the best fit of [u]Language Var[/u] for your use should be easy to choose.  Set the [u]Status[/u] of this new link to be displayed by enabling or disabling.  Type the [u]URL Of The Link[/u] in the empty field below Status.  If the new link points to a page within your Icy Phoenix, use shorthand by entering /pageofYOURurl.php.  If the new link is [u]External[/u], choose yes for the next option.  If the page is located inside your Icy Phoenix, choose no.  Just as an [u]Icon[/u] should be chosen for a category, choose an icon or use the Standard Icon for this field.  Use a unique [u]Link Description[/u].  Don't forget setting the correct [u]Permission[/u] level for this link in the drop down box at the bottom.  After setting the correct Permission, click Submit.  Repeat this process until you have created all the links you would like in the dynamic menu.
 [img align=right]http://www.icyphoenix.com/files/images/3295/createnewlinkdynmenu.png[/img] 

Pay close attention to the ID, the number to the left of your Dynamic Menu, as you'll need this ID when creating the Dynamic Menu block in your Icy Phoenix.[/list]
[hr]
[align=center]The best way to get a feel for positioning blocks on pages in your Icy Phoenix CMS is to play around with all the options available.  You are sure to create a great, feature-rich Icy Phoenix your members will enjoy![/align]

[align=center][b]Thanks for reading the Icy Phoenix Portal Guide![/b][/align]


-----------------------------------
Limun
Mon 13 Oct, 2008 19:04

Re: [DOC] Portal Guide
-----------------------------------
very very nice instructions  [img]http://www.icyphoenix.com/images/smiles/ok.gif[/img] 

exelent deatils in post ...

thank you  :wink:


-----------------------------------
gearhead
Tue 14 Oct, 2008 05:35

Re: [DOC] Portal Guide
-----------------------------------
Excellent work. Even though I've been using Icy for 1.5 years, there are many things to learn. THANKS!

 :mrviolet:  :mryellow:  :mrblue:  :mrgreen:  :mricy:


-----------------------------------
TheSteffen
Wed 15 Oct, 2008 13:38

Re: [DOC] Portal Guide
-----------------------------------
Great work [b]Chaotic[/b],

this would be very usefull for some users and for me to.

Thanks  :mricy:


-----------------------------------
Chaotic
Mon 02 Feb, 2009 23:04

Re: [DOC] Icy Phoenix CMS Guide
-----------------------------------
CMS GUIDE updated.

Added: How to switch from the nav links [Sitemap] block to dyn menu [Dynamic Menu] block.

Using the built in dyn menu [Dynamic Menu] is what the cool kids do!   :lol:


-----------------------------------
TheSteffen
Tue 03 Feb, 2009 00:24

Re: [DOC] Icy Phoenix CMS Guide
-----------------------------------
Great work [b]Chaotic[/b],

maybe you should change point 6 with point 5 ;-)


-----------------------------------
Chaotic
Tue 03 Feb, 2009 00:57

Re: [DOC] Icy Phoenix CMS Guide
-----------------------------------
:lol:

I just went back and saw that. LOL

Thanks!


-----------------------------------
stunnah83
Thu 05 Feb, 2009 02:24

Re: [DOC] Icy Phoenix CMS Guide
-----------------------------------
If this where in german...  :oops: 
Joke [b]Chaotic[/b], i can`t make it better...  :mryellow:


