====== glClassifieds - Classified Ads Plugin ======
The Classifieds plugin allows site members and administrators to submit classified ads which may be viewed and searched by others.  Normal glFusion permissions are applied to ads and ad categories.

===== Requirements =====

  * glFusion v1.1.1 or newer

===== Installation =====

The Classifieds Plugin uses the glFusion automated plugin installer.  Simply upload the distribtuion using the glFusion plugin installer located in the Plugin Administration page.

For glFusion version 1.1.1 or older, the normal plugin installation method is supported.


===== Upgrading =====

The upgrade process is identical to the installation process, simply upload the distribution from the Plugin Administration page.


===== Features =====

  * Administrators may create two levels of categories for ads.  Submission to certain categories may be restricted to certain members.
  * Site members may submit ads, including up to an administrator-defined number of photos.
  * Ads may be run for any time period, up to the administrator-defined maximum.
  * Ads may be searched for keywords.
  * Keywords may be assigned to categories, which will then become the default keywords for new ad submissions.

===== Usage =====
==== Submissions ====
Administrators and members with the "classifieds.submit" privilege can submit ads directly to the database.  Submissions by other members are governed by the "Use Submission Queue" configuration setting.

Anonymous users cannot submit ads.


===== Configuration Options =====
Configuration Options are set by the Classified Ads section in the site Configuration area.  There is no config.php required unless you wish to override any other settings.

==== General Settings ====
^Option^Description^
|Max Image Height|This is the maximum image height, in pixels, for uploaded images.  All uploaded images will be resized so that they do not exceed this height.  The aspect ratio is preserved.  Images will only be reduced if necessary, never enlarged.|
|Max Image Width|This is the maximum image width, in pixels, for uploaded images.  Refer to the "Max Image Height" setting for details.|
|Max Thumbnail Dimension|This is the maximum dimension, either width or height, for thumbnail images.  When the thumbnails are automatically created they will be sized so that both dimensions fit within this value, and the aspect ratio of the original image will be preserved.|
|Random Block Image Width|The "Random Ad" block is limited to the width configured for the site, and larger images can throw off the site layout.  If you choose to increase the "Max Thumbnail Dimension", you can leave this at a smaller value so the block is displayed correctly.|
|Max number of images|This is the maximum number of images that may be associated with an ad.  Reducing this value does not affect ads that have already been created.|
|Default duration for ads|This is the number of days that an ad will run, by default.  The submitter and moderator may change this value up to the "Max total ad duration", set below.|
|Number of days for a category to be considered "new"|In the "normal" display mode, an animated image is positioned next to categories which have been added since this number of days.  This does not affect the display of categories when the "blocks" display mode is used.|
|Number of days for an ad to be considered "new"|This setting determines which ads will appear in the "What's New" block (subject to the next setting).  Only ads which have been entered within this number of days will be shown as "new".|
|Hide ads from the What's New block|If this is set to "Yes", then nothing from the Classifieds plugin will be shown in the "What's New" block.|
|Email the admin when an ad is submitted|This setting determines when an admin receives a notification of a new ad submission:\\ - Always: An email is always sent. \\ - If Submission Queue : An email is sent only if the submission queue is used. \\ - Never: No notification is ever sent.|
|Email users upon acceptance/rejection|Like the entry above, this value determines when a notification is sent to the submitter regarding their submission:  Always, Only if Accepted, Only if Rejected, or Never.|
|Hide this plugin from the User Functions menu|This plugin doesn't appear on the User Functions menu, so this setting currently has no effect.|
|Link to seller's eBay items|This function has been deprecated and will be removed.|
|Max ads per page (expanded view)|When viewing the expanded listing, which contains some ad detail and possibly an image, how many ads should appear on one page?|
|Max ads per page (list view)|When viewing the condensed listing, found in the administrative and "My Ads" section and which shows only one ad per line, how many ads should be shown per page?|
|Max total ad duration|Here you can set the absolute maximum time for an ad to run.  The submitter (and administrator) may extend the ad's run time up to this value.  After this time, the ad will expire and cannot be extended.|
|Days after expiration to purge ads|Ads which have expired will be purged permanently from the database this many days after expiration.  To disable purging, set this to "0".|
|Days before expiration to send reminders|Reminder email messages can be sent to site members a few days before their ads will expire, if they have elected to be notified.  See the "Account Settings" documentation for details.|
|Login required to view ads|If "Yes", then no ads will be visible to anonymous visitors.  If "No", then the individual ad permissions will control whether anonymous visitors can see them.|
|Users can edit their own ads|If "Yes", then submitter and others with the "Edit" permission to an ad can edit its contents, including deleting it.  If "No", then only administrators may edit ads after submission.|
|Use glFusion task scheduler|Ad purging and expiration reminders are normally handled by a function that is called during each site visit (see "Cron Scheduled Interval" in the glFusion Miscellaneous configuration section).  If you'd like more control over when these events happen, then set this value to "No" and schedule a run of cron.php, found in the plugin's "utility" subdirectory, for the times when you'd like it to run.|
|Category Display Mode|Beginning with version 0.3, some custom display options are available.  Included in the plugin is a block-style display with some default colors.  Select either "Blocks" or "Normal" and see which you prefer.|

==== Paths and Urls ====
These values indicate where user-uploaded images and their associated thumbnails will be found.  Both Filesystem Paths and URLs should be absolute, and need not end in a "/".

==== Default Ad Permissions ====
The Ad permissions indicate who may edit or view ads, including searching.  The administrator always has full control over ads.

==== Default Category Permissions ====
Category permissions are used a bit differently than "normal" permissions.  

  * The "Read" privilege grants access to view ads in the category.
  * The "Write" privilege grants access to submit ads to the category.  Only members of "classifieds Admin" can edit or remove categories.


===== License =====

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.