https://www.icyphoenix.com/viewtopic.php?f=4&t=5385&p=36241#p36241 ----------------------------------- Chaotic Tue 03 Feb, 2009 01:15 CMS - Advanced CMS Block Guide ----------------------------------- [size=18][b]Icy Phoenix Advanced CMS Block Guide[/b][/size] [size=12][i]This document is meant as a guide for the more advanced blocks of Icy Phoenix. [b]It is also based on Icy Phoenix 1.2.18.45 Beta 1 and the future release.[/b][/i][/size] [list=1][*][url=#1][b]ads [Ads][/b] [*][url=#2]album [Album] [*][url=#3]dyn menu [Dynamic Menu] [*][url=#4]news [News] [*][url=#5]forum attach [Advanced News] [*][url=#6]forum list [Forum List] [*][url=#7]news archive [News Archive] [*][url=#8][b]news posters [News Posters][/b] [*][url=#9]rss [RSS][/list] [i][b]BOLD[/b] - New Icy Phoenix Blocks[/i] [hr] [list=1][*][url href=#1 name=1][b]ads [Ads][/b] The [b]ads [Ads][/b] block is brand new to Icy Phoenix. Advertisements are a great way to help generate a little extra cash from your website. Luckily, Icy Phoenix has a block that will help present your advertisements professionally. Choose your ad format: horizontal, vertical, or box. You can even select the size you'll need: small, medium, or large. Let's setup an [b]ads [Ads][/b] block. [img align=right]http://www.icyphoenix.com/files/images/3295/setupads.png[/img] Create a new block on any page of your website. Choose a [u]title[/u] for your new block that is unique as this will help minimize confusion. [u]Position[/u] your block wherever you would like your ads to be presented. Set the [u]status[/u] of the block to enabled so the block will be shown to your users. The [u]block file[/u] we want to use is [b]ads [Ads][/b]. Select who the block will be [u]viewed by[/u]: All, Guests Only, Registered Users, Moderators, Administrators. After selecting who can see the block, you'll need to make a few more choices in the creation of this block. The next four options are for [u]showing the border[/u], [u]showing the titlebar[/u], [u]localizing the titlebar[/u], and [u]showing the background[/u]. These options have no effect on the function of this block. [u]Localizing the titlebar[/u] will use the standard title of the block instead of the unique name you supplied in the first step. [img align=right]http://www.icyphoenix.com/files/images/3295/adsip.png[/img] You can now set some more specific permissions by selecting usergroups that are allowed to view the block. After you have finished these setup steps, click Submit and you'll be taken to a new screen with a few more options. [img align=right]http://www.icyphoenix.com/files/images/3295/insertadcode.png[/img] Depending on the size of your advertisements, you'll need to select the proper size allotment. Use your best judgment when choosing the correct size and keep in mind you'll be able to change this later if you need to. You have a few options of sizes: (H = Horizontal, V = Vertical, B = Box, 1 = Small, 2 = Medium, 3 = Large). Head back to the page you created your [b]ads [Ads][/b] block on and take note of the line you are asked to edit. An example of this is included and underlined in this picture. We need to edit [b]$banner_h_l_all in lang_main_ads.php[/b]. Open [i]language/[b]your_language[/b]/lang_main_ads.php[/i] and search for: [code linenumbers=false]$banner_h_l_all[] = 'Insert here your banner code... edit $banner_h_l_all in lang_main_ads.php';[/code] In-line FIND and REPLACE with your advertisement HTML code: [code linenumbers=false]Insert here your banner code... edit $banner_h_l_all in lang_main_ads.php[/code] After making the appropriate changes, upload the changed file to your server and your new block will be complete. Repeat the above steps for different block sizes and positions. [b]Need ads?[/b] Try: [url=https://www.google.com/adsense/]Google AdSense [url=http://www.adbrite.com/]AdBrite [hr] [*][url href=#2 name=2]album [Album] [img align=right]http://www.icyphoenix.com/files/images/3295/albumsetup.png[/img] Using the album [b][Album] block[/b] allows you to present photos/images uploaded to your photo gallery on any page of your website. You are able to present your block in vertical or horizontal fashion. Create a new block the same way as you normally would, but change the [u]block file[/u] to [b]album [Album][/b]. [list][*][u]Category To Retrieve Pics From[/u] - Depending on your photo album setup, you'll need to select which categories you would like pictures to be pulled from. (You can find the category ID's by hovering your mouse over an album category in your album.) (Your category ID is the number at the end of the link: http://MYWEBSITE.com/album_cat.php?cat_id=1.) [*][u]Number Of Images To Display[/u] - Select how many images you would like to display in this block. [*][u]Number Of Rows[/u] - Select how many rows of pictures you would like shown. [*][u]Number of Columns[/u] - Select how many columns you would like shown. [*][u]Random Or Newest Pics[/u] - Do you want random pictures or the newest pictures to be shown to your members? [*][u]Display From What Categories[/u] - Should pictures be displayed from public categories or from public and personal categories?[/list] I created a horizontal album block by: displaying three pictures, using one row and three columns, displaying newest pictures, and showing pictures from public categories. [img align=right]http://www.icyphoenix.com/files/images/3295/albumhorizontal.png[/img] [hr] [*][url href=#3 name=3]dyn menu [Dynamic Menu] Using the [b]dyn menu [Dynamic Menu][/b] block allows you to choose which menu items you would like presented to your users. Editing a dynamic menu has never been easier as you'll notice some new functionality. You can now click and drag your menu items into the order you want them displayed. [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]. [img align=right]http://www.icyphoenix.com/files/images/3295/dragndropdynmenu.png[/img] 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 differenciate 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. [hr] [*][url href=#4 name=4]news [News] [img align=right]http://www.icyphoenix.com/files/images/3295/forumnews_1224716139_156942.png[/img] The news [b][News] block[/b] is a good way to show specific topics/posts as news items on your index page. [list][*]First, go to ACP -> News -> News Configuration and enable news posting. [*]Start creating a block on the index page as you normally would, but be sure the [u]block file[/u] used is [b]news [News][/b]. [*]After customizing the options on the first screen, click Submit to head to the next step in setting up the [b]news [News][/b] block. [*][u]Number Of News To Display[/u] - How many news postings would you like displayed on your index page? [*][u]Random Or Newest News[/u] - Would you like random or newest news to be displayed? [*][u]Length Of News[/u] - 250 characters is the default, but if you'd like all text in the specific topic to be displayed, enter the number zero. Click Submit when you are finished editing these three fields.[/list] To show your news on the front page, create/edit a topic you would like to post on the index page. You'll need to select News as the [u]news category[/u], found under POST TOPIC AS and above MESSAGE BODY. [img align=right]http://www.icyphoenix.com/files/images/3295/postnews_1224718492_166504.png[/img] [hr] [*][url href=#5 name=5]forum attach [Advanced News] [img align=right]http://www.icyphoenix.com/files/images/3295/advancednewsindex.png[/img] The [b]forum attach [Advanced News][/b] block is sometimes confused as the [b]news [News][/b] block because they essentially have the same function; to show topics/posts on your index page. The [b]forum attach [Advanced News][/b] block is more customizable and has more functionality than the standard news block. Some people use the [b]forum attach [Advanced News][/b] block as a blog type system. Let's setup this block on our index page. [list][*]Be sure news posting is enabled in ACP -> News -> News Configuration. [*]Create the block like you would normally create a new block, but be sure the [u]block file[/u] is [b]forum attach [Advanced News][/b]. [*]After customizing the options on the first screen, click Submit. [img align=right]http://www.icyphoenix.com/files/images/3295/forumattach_1224719127_792669.png[/img] [*][u]Number Of Posts[/u] - How many posts would you like displayed on the index page? [*][u]Length Of Posts[/u] - Just like the news [b][News] block[/b], 250 characters is the default, but enter the number zero for all characters to be displayed within the block. [*][u]Post Forum ID's[/u] - Which forums would you like to pull news from? Hover your mouse over the forum you'd like to present on the index page and remember the ID number found at the end of the link. This number will need to be entered in this field. [*][u]Ignore Auth View Permission[/u] - By enabling this, forums view permissions will be ignored (this is important if you want to use hidden forums with NONE as view permission). [*][u]Recent Or Random[/u] - Would you like recent or random topics to be shown? [*][u]All Topics Or Only Marked[/u] - By selecting ALL TOPICS, all topics will be shown. Selecting SHOW IN HOME PAGE will require you to tick the box in the specific forum topic you'd like displayed on your page. You can find this check box under the Message Body field in posts. [*][u]Retrieve Single Post[/u] - By selecting YES, only one post will be shown in this block. [*][u]Posts ID[/u] - Enter a specific post ID to be displayed. [*][u]Get ID From Address[/u] - Enabling this will get the ID directly from address (post_id=XXX). [*]Click Submit when you are finished editing these fields.[/list] [hr] [*][url href=#6 name=#6]forum list [Forum List] [img align=right]http://www.icyphoenix.com/files/images/3295/forumlistsetup.png[/img] The [b]forum list [Forum List][/b] block is pretty straight forward, but many people underestimate it's usefulness. Try spotlighting and featuring some specific forums on your index page and make it easier for your users to access these popular forums. Create the [b]forum list [Forum List][/b] block as you normally would a new block, but make sure the [u]block file[/u] is set to [b]forum list [Forum List][/b]. List which categories you'd like to display on your index page. In my picture, I displayed all my forum categories just for testing purposes. [img align=right]http://www.icyphoenix.com/files/images/3295/forumlistindex.png[/img] [hr] [*][url href=#7 name=#7]news archive [News Archive] [img align=right]http://www.icyphoenix.com/files/images/3295/archive123.png[/img] The bloggers are going to love this advanced block. It can be a little intimidating to use at first, but once the bloggers set it up, it'll be an invaluable feature. This block allows you to store each article you post as news in an archive that enables your visitors quick and easy access to your articles. Your visitors can search your articles by category or by month and year. If you are looking for blog software, look no further than Icy Phoenix. We'll explain how to set this block up! First, create a new block on the page you wish the [b]news archive [News Archive][/b] block to be presented. Set this block up with the settings you wish, but make sure you have [b]news archive [News Archive][/b] selected as the [u]block file[/u]. After you click Submit, you'll see a new screen with a few options: [list][*][u]Show Archive Or Categories?[/u] - The Archive view shows months/years in the block. The Categories view shows the actual category names and images you have pre-selected in your ACP -> News -> News Categories. [*][u]News Image Width[/u] - This setting is set to 100% by default. Change this setting to change the image width that best fits your needs.[/list] After you have accepted these settings by clicking Submit, go to the page you added this block to and see if the look and feel is what you desired. Feel free to go back and change the settings in this block to fit your needs! [*][url href=#8 name=8][b]news posters [News Posters][/b] [img align=right]http://www.icyphoenix.com/files/images/3295/poster2.png[/img] The [b]news posters [News Posters][/b] block is a new block in this version of Icy Phoenix. This block allows you to put a block on any page of your site featuring all the contributors to your news postings. The block includes the news poster's username, avatar (if desired), when the user joined, location, various search options, and contact information. Many contributors will like this special recognition. [*][url href=#9 name=9]rss [RSS] [img align=right]http://www.icyphoenix.com/files/images/3295/rss.png[/img] Do you know of a website that peaks your communities interest? Does this website have RSS feeds? If it does, you are in luck because the [b]rss [RSS][/b] block will allow you to present the feeds of that website on your site. You have several options including: horizontal or vertical positions and static or scrolling effects. Keep your community informed by adding this block![/list]