Backpack: The Nucleus Tags Plugin!

25 Jul 2007

http://tamizhan.com/downloads/tags.zip

The Tags Plugin Pack

Essential Steps

Install NP_tags
- In Add and Edit Item screens you will now see a textbox for adding tags.
- For editing to work, you must add the single line core change documented here => http://forum.nucleuscms.org/viewtopic.php?p=25774#25774
- If you use normal URLs :
  - Make an empty new skin (Go to the Skins page. Use the New Skin in the bottom of that pageto create an empty new skin).
  - Let us assume you called this new skin tags.
  - Copy the Main Index part of the skin you use to display your blog and paste it into the Main Index part of this skin.
  - Replace the <blog(template,number)> in this skin with <Tags(template,number)>.
  - Make a copy of your index.php (or whatever is your blog’s URL) in the root of your webserver. call it whatever you want. I would suggest tags.php.
    - Edit this file.
      - Change $CONF[‘Self’] to whatever you gave as the name for the file above i.e tags.php
      - Above selector(), put a selectSkin(skin_name)%>; line. The skin_name should be the same as the name of the skin above.
- If you use Fancy URLs :
  - Copy the tags file in the zip file to the root of your webserver. This is the same place where you will find other Fancy URL files like item, blog etc.
  - Add a line in your .htaccess file for tags in a similar way you have done for item, blog etc.

Install NP_TagInfo
- Go to options page
- Change the option “Text used to be used while creating the normal URL :” to the whatever name you gave for the copy of index.php you created above. This is applicable only if you are using normal URLs.
- If you don’t want the liquid tag display effect, then blank out the href option.
- If you wan’t, then keep it as it is. Include the prototype.js file included in the zip in the head section of your skin.
- In your skin, use <TagInfo(number,min,max,random)> to show the tag cloud.
  - Number is the number of posts to pick the tags from.
  - Random can take 0 or 1.
    - If 0, will show most recent.
    - If 1, then will show a random collection of tags.
    - If the CacheLite is installed, it will automatically cache results. So random will work as random only every hour (depending on your cache lifetime) ;)
  - The min, max values should be in em.
  - An example will <TagInfo(50,1,4,1)>
- You can put <TagInfo> in your template to show the tags for a particular item.

Install NP_ItemsInTag
- Just installing is fine.
  - You can choose to include search results in your list as well. For this, use the option in the edit options page.

Recommended Steps

Install NP_CacheLite
- Although this is not a necessary step, it is highly recommended. The TagInfo TagsCloud and the post listing with search results included are highly mysql intensive. Having a cache helps in reducing the server load and speeds up the page loading.
- After install, go to the plugin options screen and set the cache lifetime. This is measured in seconds. I would suggest you leave this figure as it is. 3600 maps to one hour.
- Go inside the plugins/cachelite folder and create a folder called tmp. Chmod this to 777.
- Thats it. The other plugins will automatically use this cache now onwards.

Install NP_AutoComplete
- Again, though not necessary, highly recommended.
  - There is an option available whereby you can control the number of items the plugin will hold in memory. 50 is a good number.
- Go to your add item / edit item screen and start typing in the tags box.

Misc

Install NP_AutoTag
- Just installing is enough. Not fully done. Might not catch all the links.

Install NP_ImagesInTag * Just installing is enough. Not fully done. Might not catch all the posts with images.
- Go to your domain.com/tags/-/images (if you are using Fancy URLs).
- Else go to your domain.com/index.php?-=images (if you are using normal URLs).