Now your Tiki is ready to receive RSS feeds. So, how do you insert them into your site? If you'd like to have them appear as a module in one of your columns, you must create a new user module. For full information on module creation, please see Modules Admin.
As an admin-level user, click the Modules link from the Admin (click!) section of the Application menu to enter the Admin Modules screen. Scroll down to the Create new user module panel.
First time administrators of Tiki may think that this means you are creating a module for a new user. But no! You are creating a user module for the first time--that is, a new one!
- A Name for your module, which will be used to identify it later.
- A Title, which will appear on screen when the module is displayed.
- data, that is, a bit of code
HTML permittedthat incorporates your channel(s) into the module. RSS-channel data is displayed using the following syntax (remember the ID number that we created for each RSS channel?):
- Replace x with the ID number of the channel.
- Replace y with the maximum number of items that you want displayed.
- In this example, we've used the channel-feed ID number for Slashdot on our system and limited it to five items.
- Tiki will automate this process for you:
- From the Objects that can be included side of the panel, pick a channel from the drop-down list labelled RSS modules. Then click the link, use rss module to automatically insert the channel data into the data box.
- However, it will not set a max number for you.
- You may now embellish the module data by adding HTML tags. In this example, we wanted the Slashdot headlines to be numbered and so we added a ordered list tag to it.
- Tiki provides a basic WYSIWYG (What You See Is What You Get) editor to facilitate HTML coding. Click Use wysiwyg editor to try it out.
- Tip: You can include more than one RSS channel in a single module.
- Click create/edit to complete the module-creation step.
Next, you must tell Tiki where to display this new module. In other words, you must assign it to the Tiki layout.
- Once you've create your RSS user module, it'll appear in the Module name drop-down list in the Assign new module panel. Select it.
- Decide on its Position in the left, center or right column of your Tiki.
- Give it a number to determine its relative Order (top to bottom) in the column.
- Select which Groups will be permitted to see this module. Select more than one group by Control-clicking.
- Group permissions are explained further in PermissionAdmin.
- Click preview to see what your module will look like. When you're satisfied, click assign.
- For example, here's how our Slashdot module turned out:
Once it's been assigned, it'll appear in the Assigned Modules panel, where it may be edited, moved up/down, or deleted (the x link).