=== One Quick Post ===
Contributors: G.Breant
Donate link: http://dev.pellicule.org/?page_id=19
Tags: BuddyPress,quickpress,post,quick post,frontend,guest
Requires at least: Wordpress 3
Tested up to: Wordpress 3.0.1, BuddyPress 1.2.6
Stable tag: 0.4.2-alpha

One Quick Post is a WordPress/BuddyPress plugin that allows you to enable frontend posting on your blog, even for guests.


== Description ==

One Quick Post is a WordPress/BuddyPress plugin that allows you to enable frontend posting on your blog, even for guests.

    * build your custom forms. You can split a form into several steps. You can use custom post types, custom taxomies, custom fields (meta keys)...
    * You can include OQP forms into posts or pages; but also in a template or plugin.
    * Used as core plugin of "Your Classified Ads" plugin.
    * BuddyPress ready (experimental)
    * You can enable guest posting. They'll just have to give their name and email.
    * Ability to use captchas using the "SI CAPTCHA Anti-Spam" plugin.
    * Works with the WordPress roles & capabilities system : if a user send a post; will it pend or will it published ?  Is the user allowed to edit a published post ?
    * Notifications: you can enable the notifications; that will email the user when his post is pending, has been published or has been deleted.  As admin; you can write the reason of the deletion of a post in an optional box.  This would be included in the notification sent to the user.
    * ability to upload pictures
    * ability to mark some locations on a map from Google Maps using the "GPress" plugin.
    * works on multiple blogs installations (selecting the blog where you want to post on is possible) ! this feature needs more testing

Future

    * Notifications (not only emails) for BuddyPress
    * Ability to geo search posts (eg. for classifieds ads, you could search 20km around you)
    * Allow to use custom meta keys in the form
    * ...



== Installation ==

1. Check you have WordPress 3.0+
2. Download the plugin
3. Unzip and upload to plugins folder
4. Activate the plugin

== Frequently Asked Questions ==

= Notifications : When I delete a post from a user, how can I add the reason to the notification ? =
Add a custom field 'oqp_mod_message' to this post.  The value will be the reason why you did moderate this post.  Save it, then only delete the post.
The reason will be included in the notification.

= Form fields : How can I add descriptions to the fields ?=
Just add filters in the file functions.php of your theme
///FOR THE TITLE
function my_title_description($text) {
	(...)
	return $text;
}
add_filter('oqp_form_title_description','my_title_description');

///FOR THE DESCRIPTION
function my_content_description($text) {
	(...)
	return $text;
}
add_filter('oqp_form_content_description','my_content_description');

///FOR THE PICTURES UPLOAD
function my_pictures_description($text) {
	(...)
	return $text;
}
add_filter('oqp_form_pictures_description','my_pictures_description');

///FOR THE MARKERS
function my_markers_description($text) {
	(...)
	return $text;
}
add_filter('oqp_form_markers_description','my_markers_description');

///FOR THE TAXONOMIES
function my_taxonomy_desc($description=false,$tax_obj) {
	(...)
	return $text;
}
add_filter('oqp_form_taxonomy_TAXNAME_description','my_taxonomy_desc',10,2); //WHERE TAXNAME is the taxonomy name

///FOR THE CUSTOM FIELDS
function my_custom_field_desc($description=false,$field_settings) {
	(...)
	return $description;
}
add_filter('oqp_form_custom_field_MYFIELD_description','my_custom_field_desc',10,2); //WHERE MYFIELD IS THE META KEY

= Custom fields & Taxonomies : How can I change the way the plugin renders the field or validates the data ? =
Just add filters in the file functions.php of your theme.
Eg. here; the field meta key is MYFIELD.

///CHANGE THE CUSTOM FIELD INPUT IN THE OQP FORM
function my_custom_field_price_display($html,$field_settings) {
	(...)
	return $html;
}
add_filter('oqp_form_render_custom_field_MYFIELD','my_custom_field_price_display',10,2);

///CHANGE THE CUSTOM FIELD VALIDATION
function my_custom_field_validation($is_valid,$value,$field_setting) {
	(...)
	return true; //or false !
}
add_filter('oqp_validate_custom_field_MYFIELD','my_custom_field_validation',10,3);

Same for taxonomies :
add_filter('oqp_form_render_taxonomy_MYTAXNAME','my_taxonomy_display',10,3);
add_filter('oqp_validate_taxonomy_MYTAXNAME','my_taxonomy_validation',10,3);


== Screenshots ==

1. Used with Your Classified Ads plugin : Place a new Ad Step #1 (details)
2. Used with Your Classified Ads plugin : Place a new Ad Step #2 (settings)
3. Used with Your Classified Ads plugin : Place a new Ad Step #3 (pictures)
4. Used with Your Classified Ads plugin : Place a new Ad Step #4 (markers)

== Changelog ==
= 0.4.2 =
* Fixed shortcode problem
* Fixed post admin from frontend
= 0.4.1 =
* Now retrieves guest avatar from custom meta key email (filter get_the_author_user_email)
* Added notifications for BuddyPress
= 0.3.9 =
* Various fixes
* BP version currently disabled because being rewritten
= 0.3.8 =
* Language localization
* Priority hooks corrections
* Buddypress compatibility still is buggy
= 0.3.7 =
* Better CSS
* Now handles custom fields !
* Added a form option for Terms & Conditions before posting
* Added filters to add descriptions to the form fields.  See FAQ.
= 0.3.6 =
* BuddyPress fixes about how oqp_bp_init & oqp_init are hooked
= 0.3.5 =
* Various fixes and improved the admin
= 0.3.4 =
* Bugfix (yclads_maps_is_setup)
= 0.3.3 =
* Lots of changes !
= 0.2.7 =
* Bug fixes
= 0.2.6-alpha =
* Bug fixes about guest posting
= 0.2.5-alpha =
* Implemented simple image uploader.  Will be improved.
= 0.2.4-alpha =
* Bug fix 'cannot add header information'
= 0.2.3-alpha =
* Taxonomies bug fix
* Capabilities bug fix
= 0.2.2-alpha =
* Bugs fixes
= 0.2.1-alpha =
* Changed the way taxonomies can get arguments (filtering, ...)
= 0.2.0-alpha =
* Lots of bug fixes
* Added Captcha function
* Better notifications
* Better theming support
= 0.1.9-alpha =
* Guest posts query / url are now checking for the posts with a same guest email
* Bug fixes
= 0.1.7-alpha =
* Bug fix in the shortcode
= 0.1.6-alpha =
* Added expandable categories
* Changed the way the shortcode (& taxonomies) are handled (more flexible)
= 0.1.5-alpha =
* Tiny MCE (Wysiwyg Editor)
* New file structure
= 0.1.4-alpha =
* New file structure
* Redirection bug fixed
= 0.1.3-alpha =
* Capability bug fixed
= 0.1.2-alpha =
* BuddyPress bug fixed (http://dev.pellicule.org/bbpress/topic/one-quick-post-for-buddypress-issue)
* Mails improved
= 0.1.1-alpha =
* New admin option to send the user a mail when a post status changes from pending to publish
= 0.1-alpha =
* First release

== Support ==
[Support forums](http://dev.pellicule.org/bbpress/forum/one-click-post)

== Roadmap ==
* Better BuddyPress integration
* Better mailing system
* Delete pictures
* Change featured thumbnail

== Bugs ==
* If the poster has not at least the contributor status; he is no more credited as author when the post is updated.