Plugin: Skills[cj_skill] Documentation

This plugin allows you to build a database of skills offered and wanted and for anyone who is registered to see who is offering the skills they need or needs he skills they can offer.

The plugin builds on the WordPress menu system and uses  the cj_menu plugin for some of its functionality

This means that:

1. You will need to install the cj_menu plugin
2. If you are not using a theme that normally uses menus, a plugin to allow you to create and edit menu trees.

Follow these steps.

1. Make a list of skills. You can organise them into  groups and sub groups.
2. Make a page for each skill briefly describing it.
3. Make a menu tree using the WordPress menu editor. It does not need to be a menu that is ‘placed’ by WordPress or your theme. Normally you would create a new menu
4. Add the pages to the menu tree arranging them according to the groupings you chose and then save the menu
5. Make a page to offer the user the different skills so that they can indicate what interest (if any) they have in each skill. You can make a page for the whole tree, or you can have separate pages for different groups.
6. On this page you add a cj_menu shortcode (this is where the cj_menu plugin is needed) The format is like this:

   [cj_menu  
                      menu=<mymenu> 
                      selection=root 
                      format=selectors 
                      level=0 
                      properties="learn:Learn teach:Teach buy:Buy sell:Sell none:None_of_these"
                      default=none 
                      prefix=skill_weights
                      id=<slug>
      ]

   where

   <mymenu>

   is the name of the menu tree you used in step 3

   selectors

   is used to select this particular type of format

   properties

   is the definition of a list of radio buttons to show

   default

   is the button to show pressed if the user has not yet made any selection

   prefix

   is the name of the application. This must be specified in case you have more than one app using this facility. The app name is quoted whenever this database is accessed.

   <slug>

   can be left out if you want the whole menu from its root, but if you want to start from a specific point in the menu, find the slug for that page and put it in here. Alternatively, if you want to offer the sub group from the group page, just specify selector=offspring instead of selector=root

Add any explanatory text, and save the page

Only Registered and logged in users will be able to see the list. Others will be invited to register and log in.

On a separate page you use the cj_skills shortcode to show the user the people who match his skill offerings and needs. It is best to not use the same page, as this forces WordPress to update the database with the users skill preferences before they check their matches.