======glClassifieds - Routine Administration======
Routine Administration of the classified ads plugin consists of managing categories and ads.  System-wide settings are covered in the [[System Administration]] section.

The administration page for glClassifieds is accessed from the Plugin administration screen.

=====Managing Categories=====
Categories can be created to group ads together by topic.  At least one category must be created or the plugin will not accept submissions.

Categories have the following attributes:
| Name | The name of the category.  This should be a short, simple name, such as //Cars//, //Cameras//, //Boats//, etc.  Long names, or names with spaces, can make the plugin home page confusing.|
| Parent Category | This list contains all of the root-level categories.  If the category that you're creating is a sub-category, select its parent here.  This way you can create a 2-level hierarchy of categories |
| Keywords | Enter a space-separated list of keywords to be used for searching.  These will become the default keywords for new ads entered in this category, but may be overridden by the user.  \\ Also, if the user or administrator changes an existing ad's category, the new category's keywords will overwrite the current ad keywords. \\ The keywords are used to assist in searching the ads, but are not displayed on the ad detail screen. |
| Image | An optional image can be upload to serve as an icon for the category.  The icon appears on the plugin home page, for root-level categories only.  This image should be a 48x48px JPEG image, since it will be displayed in that size by the plugin. |
| Owner | The category owner.  This is automatically set to the current user and cannot be changed.  This field has no function currently, but may in the future. |
| Group | A group can be associated with the category for purposes of allowing or disallowing ad viewing or submission. |
| Permissions | This is a normal glFusion permission assignment block.  Category permissions are discussed in more detail below. |
| Propagate Permissions | If this checkbox is checked when the category is saved, then the permissions set in the permission block are automatically propagated to each sub-category.  Naturally, this only has an effect when editing an existing root category. |

==== Permissions ====
Permisssions have slightly different meanings for categories than for ads.  For categories, the //Write// permission means //Able to submit to this category//, while //Read// means //Able to view ads in this category//.  Some examples might be helpful:

  - Allow specific users to submit ads, Site Members to view, and no access for Anonymous users
    * Group : User group containing specific users : Read & Write granted
    * Members : Read granted
    * Anonymous : Read disabled
  - Allow all members to submit ads, Anonymous users to view ads
    * Group : Logged-In Users : Read & Write granted
    * Members : Read granted
    * Anonymous : Read granted

Note that anonymous users may never submit ads.  Also members of Root always have full access to categories.

When deciding whether to display an ad to a user, the ad's permissions and the ad category permissions are both checked and the least permission is granted.  For example, if anonymous users are allowed to view ads in a given category, but one ad in that category has revoked //Read// access from Anonymous, then that ad will not be displayed to Anonymous, while others will be.

The category tree is not traversed to find permissions.  Only the ad's assigned category is checked.  If you wish to grant or revoke permission to an entire category tree, then you need to edit the root category and //propagate// the permissions downward.  If there are special exceptions, you'll need to change those permissions afterward.

===== Managing Ads=====
Managing Ads consists of editing and deleting ads.  The submission queue is handled by glFusion.

The Edit form looks almost like the submission form.  For administrators, it's identical.  Any fields may be changed, with some exceptions:
  * The ad's runtime may be extended by a user-entered number of days, but may not be reduced.
  * Existing images may be deleted.  They will be removed from the database and deleted from disk.

For descriptions of the fields, see the [[Submissions]] documentation.

===== Other =====
The //Other// tab contains additional functions which may be required from time to time.

==== Reset Permissions to Default ====
These two permission blocks allow the administrator to globally reset all category or ad permissions to the specified values.

In version 0.2.3, the category permissions began to be used in conjunction with the ad permissions to determine access to ads and not solely for access to categories.  After upgrading from an earlier version, the permissions may not be set up correctly.  These functions allow for the administrator to fix that problem quickly.

After executing either of these reset functions, the administrator will need to manually make any exceptions to individual categories or ads.