=== Another Wordpress Classifieds Plugin === Contributors: awpcp.com Donate link: http://awpcp.com/donate Tags: classifieds,ads,classified ads,classified,awpcp,classifieds script,classified script,classified theme,classifieds theme Requires at least: 2.7 Tested up to: 3.2.1 Last Updated: 2011-Aug-19 Stable tag: tags/1.8.9.1 Another Wordpress Classifieds Plugin provides the ability for you to add classified ads to your Wordpress blog. Great for increasing retention to your site, adding revenue for your business, and increasing customer interaction. == Description == Add a classified ads section to your Wordpress site, quickly and easily. Lots of features, very configurable. Easy to setup. Great support. We're the #1 Wordpress Classified Ads Plugin: two years old and 80,000+ downloads! Fee Per Category NOW AVAILABLE (see below)! Don't miss Featured Ads, too! Features: = Ad Features = 1. Search ads by city, state, country, username, or keyword 2. Allow AdSense ads to be displayed 3. Control over HTML use in ads 4. Limit the text size of ad postings 5. Standard form fields can be enabled or disabled, depending on your needs (title, website, name, country, etc) 6. Allow or disallow image posting with ads 7. Automatic expiration of ads (free or paid) 8. Configurable ad display for AdSense placement 9. Ads can have a "Tweet This" button in their layout 10. Ads can have a "Share on Facebook" button in their layout 11. Ads can be flagged by community for bad/offensive content = Notification Features = 1. Allow posters to be notified of expiring ads 2. Allow admin to be notified when new ads are posted 3. Classified ad users can contact the ad poster without exposing the poster's email (blind email system, similar to Craigslist) 4. Admin can (optionally) be notified of expiring ads = Payment Features = 1. Allows for paid or free ads 2. Supports PayPal and 2Checkout for paid ads 3. Google Checkout support for paid ads also through a Premium Module 4. Allow for image posting limits higher than free ads 5. Multiple fee scales for posting ads (allows you to have longer ad postings with higher fees) 6. Variable ad expiration lengths connected to fee scale (e.g. allow ads to run for 30 days for $10, 60 days for $15, etc) = Ad Posting Controls = 1. Allow admin to approve ads prior to posting 2. Allow admin to approve images prior to posting 3. Users can edit or delete their own ads 4. Admin can edit or delete all ads in the system 5. Secure system gives users a unique editing key to administer their own ads 6. Allows for limiting image posting (by image size, height, width and total count if desired) 7. Anti-spam checks for all ads posted via Akismet. 8. Flagged ads can be viewed separately to determine violations, and then deleted or unflagged. = Image Features = 1. Allow image posting or shut it off completely 2. Control the number, filesize, height and width of images posted 3. Allow for different numbers of images to be posted with paid ads vs. free ads 4. Allow for image approval prior to posting = Premium Modules (Add on modules, not included with free plugin) = 1. Category Icons (adds small icons to give visual cues to your user for each category in AWPCP) 2. Extra Fields (allows you to add any custom fields for display. For example, if you have a pet-related board, you might have "Sex", "Breed", and "Dam/Sire" as additional fields you require for display) Now supports search in extra fields, too. 3. Regions Control (allows you to restrict viewing of ads based on locale, so users don't see items they aren't physically near them, also allows customization of the region types, such as village, borough, etc) 4. Google Checkout (allows you to support Google Checkout as a payment method for paid ad posting) 5. RSS Feeds (allows you syndicate your classifieds for your users to download in their favorite RSS reader and come back to your site more often!) 6. Featured Ads (allows you to promote certain ads over others by charging a fee for them, featured ads are displayed using CSS to highlight them. Featured ads are always returned first in a category, the overall ad list, or in search results. Also has a widget for placement anywhere on your site. Full admin control of featured ads, too) 7. **NEW** Fee Per Category (allows you to charge for certain categories and not others, giving you more freedom on how to configure your classified section. Allows for multiple fee plans per category, as well as a default plan to cover "all other unspecified" categories) = Premium Module Links: = [Category Icons](http://awpcp.com/premium-modules/category-icons-module?ref=wp) [Extra Fields](http://awpcp.com/premium-modules/extra-fields-module?ref=wp) [Region Control](http://awpcp.com/premium-modules/regions-control-module?ref=wp) [Google Checkout](http://awpcp.com/premium-modules/google-checkout-module?ref=wp) [RSS Feeds](http://awpcp.com/premium-modules/rss-module?ref=wp) [Featured Ads](http://awpcp.com/premium-modules/featured-ads-module?ref=wp) [Fee per Category](http://www.awpcp.com/premium-modules/fee-per-category-module?ref=wp) Or, just [Donate to AWPCP to Support further development](http://awpcp.com/donate?ref=wp) These are just some of the features of Another Wordpress Classifieds Plugin For more information and support please visit [http://awpcp.com](http://awpcp.com?ref=wp) For plugin support please visit [http://forum.awpcp.com](http://forum.awpcp.com) If you love the plugin, [please consider purchasing a Premium Module](http://awpcp.com/premium-modules/?ref=wp)! == Credits == Copyright 2009-11 awpcp.com Special thanks to Mark E of http://SimplerComputing.net for his contributions to the plugin! AWPCP Classifieds icons courtesy of http://www.famfamfam.com/lab/icons/silk/ dcfunctions.php used with permission under GPL by Dan Caragea http://www.datemill.com fileop.class.php used with permission under GPL by Dan Caragea http://www.datemill.com 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. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA == Installation == = IMPORTANT = Please backup your wordpress database before you install/uninstall/activate/deactivate/upgrade Another Wordpress Classifieds Plugin. Pre-installation note: If you have previously tried other classified plugins and you plan to give the classifieds page created by Another Wordpress Classifieds Plugin the same name as previously used with other classifieds plugins you've installed, please make sure your database has been cleared of any entries in the wp_posts table where the post_name value and the post_title value are the same as the name you plan to give your classifieds page. For example, if your classifieds page will be named "Classifieds", you might have a wp_posts database entry post_title value of "Classifieds" and post_name value of "classifieds" still left over from previous installations of other classifieds plugins. You need to check your database to make sure data from your previous classifieds plugins does not still exist. Specifically, you need to delete all entries from your wp_posts table where the post_title and post_name values are the same as what you plan to name your classifieds page. 1. Upload the folder another-wordpress-classifieds-plugin with its contents to wp-content/plugins/ 2. Activate the plugin 3. Click on the "Click here to setup your site options" link and fill out all your various options to configure how you want your classifieds to run. 4. After you have setup your options you should create some categories and sub categories for your classifieds 5. After you have created your categories you should setup your payment fees if you are going to be running in pay mode. Your classifieds should now be ready and working. If you are having problems please visit the [support forum](http://forum.awpcp.com) for technical questions, documentation and FAQs. == Screenshots == [Visit the main site for screenshots](http://www.awpcp.com/features) == Frequently Asked Questions == Question: Will this plugin work with versions of WordPress earlier than 2.7? Answer: The plugin has only been tested with version 2.7 and above. If you wish to test it on earlier versions you are free to do so. If you find that it works on an earlier version please consider sharing this information for the benefit of others. Question: Does your plugin have any particular requirements for PHP or MySQL versions? Answer: Yes, you need PHP 5+ and MySQL 5+. Earlier versions may work, but are not officially supported. Visit the support forum for [support, FAQs and docs](http://forum.awpcp.com) Find the [faqs here](http://www.awpcp.com/category/questions-answers/) [Plugin documentation](http://www.awpcp.com/about-2/) == Changelog == = 1.8.9.2 = Bug: Fixed pagination issue with category pages. Bug: Fixed critical bug where install caused WSOD with conflicting page names. Bug: Fixed layout issue with categories not aligning correctly. Bug: Fixed Extra Fields category problem for root fields Bug: Fixed so city/state are displayable in the listing AND details of ads = 1.8.9.1 = Bug: Fixed extra fields category problem in main plugin. = 1.8.9 = Bug: Fixed SEO mode, simplified usage in admin, corrected numerous bugs from SEO glitches. = 1.8.8.1 = Bug: Fixed function name for old Extra Fields module validation. = 1.8.8 = NEW: Integrated changes for Extra Fields to support ad listing display, search field hiding, category-specific fields NEW: Added support to auto-resize regular images (instead of just thumbnails) on upload NEW: Added support for category editing (admin only) Bug: Fixed pagination problems with browse ads Bug: Fixed issue with disabled ads being reachable via URL directly Bug: Fixed ad email issue (editing caused email resend) Bug: Fixed category delete SQL error Bug: Fixed Akismet integration to catch more spam Bug: Fixed image editing for admin, improved admin panel functionality for images Bug: Fixed SMTP to support port designation, fixed SMTP usage Bug: Fixed Akismet integration to detect if it's missing (prevents the "setting save" problem when Akismet not active) Bug: Fixed ad editing with images in top level categories Bug: Fixed place ad/display ad form spacing (reduced white space) = 1.8.7.2 = Bug: Fixed unclosed ul and li items for empty categories Bug: Fixed CSS spacing issues with certain themes that put huge margins in the categories Bug: Fixed CSS spacing issues with Place Ad/Search Ad form (cut down on spacing between fields) = 1.8.7.1 = NEW: Support for Fee Per Category plugin added Bug: Fixed PayPal bogus error message on successful payment issue Bug: Fixed Place Ad issue where the first fee plan isn't selected Bug: Fixed website link to open in a new page Bug: Fixed Windows bugs for uninitialized variables = 1.8.7 = Bug: Fixed category problem when editing ads Bug: Fixed problem with error on deleting ad images Bug: Fixed pagination issues Bug: Fixed field escaping for category names Bug: Fixed Notify admin of Ads textbox problem Bug: Fixed issue where disabled ads could be accessed via URL directly Bug: Fixed problem with 1-character domain emails (e.g. q.com) = 1.8.6.4 = Bug: Fixed column issue for fee plans Bug: Updated license terms for all files according to WP terms of service requirements = 1.8.6.3 = Bug: Fixed ad edit for admin panel (category error) Bug: Fixed free ad end date bug (Jan 1, 1970), added mechanism to update end date in free mode = 1.8.6.2 = Bug: Fixed bad column names in functions_awpcp.php = 1.8.6.1 = Bug: Fixed install problems with categories tables, flagged column, etc. Bug: Fixed sort order of ads for all types Bug: Fixed Facebook share button title to use actual ad title = 1.8.6 = NEW: Facebook share button for individual ad pages. To use it, make sure you have $sharebtn in your single ad template NEW: Added field codes for single ad display: $ad_postdate, $ad_startdate, $ad_categoryurl NEW: Added ability to hide/show "Posted By" on search form NEW: Flag Ad link for individual ad pages. To use it, make sure you have $flagad in your single ad template NEW: Terms of Service displayed for ads (optionally), if displayed, user must select accept. NEW: Admin can be notified of ads that expire (optionally). NEW: Admin panel now displays start/end date for ads, payment plan (if applicable) NEW: Admin panel has separate category for notification email templates (subject and body) NEW: Added IP address tracking for ad posters to improve Akismet spam detection when spam is marked later Bug: Fixed search form to hide private extra fields Bug: Fixed conflicting function name display_ads to be awpcp_display_ads Bug: Fixed ad expiration bug Bug: Fixed expired ads did not delete automatically (30 day delay now) = 1.8.5 = NEW: Tweet button for individual ad pages. To use it make sure you have $tweetbtn in your single ad template NEW: Ability to use your own custom stylesheet ( found under wp-content/plugins/awpcp_custom_stylesheet.css ), which isn't overwritten on upgrade. NEW: Support added for Featured Ads premium module NEW: Added field code $ad_categoryname for ad display listing Bug: Fixed latest ads to display intra-day postings in descending order of ID after date Bug: Fixed display of UI Welcome message (backslash problem) Bug: Fixed city display in URL and page title (was missing even if city was valid) Bug: Fixed failing ad expirations Bug: Made the latest ads display consistent with the ad listing layout (thickbox around image) = 1.8.1 = Bug: Display went crazy with Latest Classifieds widget on upgrade. Removed unnecessary div. = 1.8.0 = NEW: Normalized version numbering to remove superfluous 0 (1.0.8.0 is now 1.8.0) NEW: Search widget NEW: Search works with Extra Fields NEW: Sitemap integration with Google Sitemap Generator (as separate plugin) NEW: Admin panel upgrades Bug: Fixed renewing ads failing to re-enable images Bug: Fixed workflow issue with free ads that don't have images (missing Next button) Bug: Changed showad id for div to showawpcpadpage to stop AdBlockPro/Plus from interfering with classifieds Bug: String extraction for ad terms Bug: Fixed widget backslash issue Bug: Fixed checked='checked' for XHTML compliance Bug: Fixed admin email spam for expiring ads, updated text for expiring ad emails = 1.0.7 = NEW: Added full Akismet integration for spam control NEW: Added ad multiple spam submit in admin panel Bug: Fixed ad expiration to go against the ad expire setting, instead of end date Bug: Registered user name cleanup, added email hack for plugins that override get_currentuserinfo Bug: Backslash addition removed for all admin-level settings fields (unnecessary) Bug: Backslash encoding for single quotes added back for WP page inserts (required) Bug: Fixed unclosed img, li, and option selected for XHTML compliance Bug: Fixed bug with Checkhuman field not displaying (put 'inputboxmini' class on it) Bug: Fixed issue with RSS module and URLs requiring trailing slash for SEO Friendly URLs Bug: Removed dead functions to reduce size Bug: Updated workflow to remove image step if imagesallowed == 0 = 1.0.6.18 = NEW: Added ability to approve/disable at all times Bug: Reverted ad expiration changes from .17, re-enabled disabled ads = 1.0.6.17 = Bug: Translation file string fixes Bug: Backslash fixes for sidebar widget, AdSense = 1.0.6.16 = NEW: Added options to Latest Ads widget for image display Bug: Fixed bug regarding category ordering in the drop-down list under Browse Ads Bug: Fixed admin email override failure Bug: Fixed issue with ad layout HTML codes and backslashing = 1.0.6.15 = NEW: Image thumbnails now display in Latest Ads widget Bug: Fixed bug where thumbnails in ad lists did not have link to ad Bug: Set default search for listing in Admin panel to Keyword Bug: Fixed ad blocking problems by changing class 'adinfo' to 'cladinfo' Bug: Fixed editor role to allow for access to AWPCP Admin menu Bug: Fixed search to send back error when search keyword is < 4 letters Bug: Fixed pagination problem with Browse Categories = 1.0.6.14 = NEW: RSS Module Support Bug: Fixed display problems with Extra Fields Module Bug: Fixed bug where users without POSIX installed got image upload errors Bug: Updated string handling for internationalization = 1.0.6.13 = Bug: Fixed PayPal output bugs Bug: Fixed slash escaping for all fields Bug: Added array_walk_recursive function for PHP4 users Bug: Fixed upload directory creation ownership issue = 1.0.6.12 = Bug: Fixed category insert/delete bug Bug: Fixed admin panel edit for ads Bug: Fixed slash escaping for ads = 1.0.6.11 = Bug: Fixed admin widget display = 1.0.6.10 = NEW: Support for WordPress 3.0 NEW: Support for category ordering NEW: Compatibility fix for Simple Facebook Connect Bug: Fixed image upload problem where directory not found = 1.0.6.9 = Bug: Fixed $awpcpvisitwebsite missing from display codes