﻿/*============================================================================*\
|| ########################################################################### ||
|| # Product Name: Advanced Quick Reply                       Version: 2.0.0 # ||
|| # License Number: Free License                           $Revision: 126 $ # ||
|| # ----------------------------------------------------------------------- # ||
|| #                                                                         # ||
|| #         Copyright ©2005-2008 PHP KingDom. Some Rights Reserved.         # ||
|| #   This product may be redistributed in whole or significant part under  # ||
|| #      "Creative Commons - Attribution-Noncommercial-Share Alike 3.0"     # ||
|| #                                                                         # ||
|| # -------------- 'Advanced Quick Reply' IS FREE SOFTWARE ---------------- # ||
|| #     http://www.phpkd.net | http://www.phpkd.net/info/license/free       # ||
|| ########################################################################### ||
\*============================================================================*/


Please remember to click Mark as Installed if you use this modification.
Support questions from members who have not marked this as installed will be considered low priority.


Many thanks:
   * All vBulletin experts.
   * vBulletin.com for their professional products and premium support.
   * vBulletin.org for their articles, mods [Thanks also to articles' authors & products' coders].
   * Paul M for his kind permission for using same scenario of his 'product debug info system'.


Name: Advanced Quick Reply

Description: This product extends 'Quick Reply' functionality to allow all "Advanced Editor mode" options [ All Built-In BBCodes / Smilie Box / Smilie Menu / Attachments ] (with full control from AdminCP).

How it works:
   * Simple:
	o Adds functionality of the full editor to the quick reply [ All Built-In BBCodes / Smilie Box / Smilie Menu / Attachments / Thread Management Tools ] - [ 5 In 1 ].
   * Detailed:
	o This product is totally different from other similar products, it doesn't depend on any other codes and doesn't fake vBulletin telling it that this editor is advanced reply not quick one, it leaves every thing as default but extends 'quick reply' functionality by having it's own independant code.
	o It adds all allowed buil-in bbcodes buttons to the quick reply editor (with full control).
	o It adds fully functional Attachments options in quick reply [Fully Functional (can control attachments in the quick reply as you do in the advanced editor mode, you also have the drop down menu button in the editor itself contains all attached files to embed them if you like in post with the [attach] bbcode as usual) |||  Fully Ajaxified (Yes, it's supports all vBulletin AJAXY functions in addition to rebuilding quick reply attachments' options after posting quick reply) ].
	o It adds thread management options to control the thread from the quick reply itself ( Open / Close / Stick / Un-Stick ), if management action taken from the quick reply the product will rebuild all related data within that thread on fly (dynamically), that's means if you chosen to close that thread it will close it & change the phrase "Close this thread after you submit your message" to "Re-open this thread after you submit your message" & "Close Thread" (in the moderation tools) to "Open Thread" & change the reply button to "threadclosed.gif" image, the product acts this way with all management options also (opening / sticking / un-sticking).
	o After submitting the quick reply, the product auto 'un-check' the checked check boxes & rebuild the attachment list & do appropriate actions related to the actions selected dynamically/instantly without reloading.


Features:
   * Specific Features:
	o Can enable/disable product globally. [1.0.0]
	o Can select which Built-in BB Code Tags (enabled buttons). [1.0.0]
	o Can display full functional SmilieBox. [1.0.0]
	o Can display full functional SmilieMenu. [1.0.0]
	o Can set "SmilieBox Total Smilies" for this editor alone (Doesn't depend on default system settings for advanced reply). [1.0.0]
	o Can set "SmilieBox Smilies Per Row" for 'Quick Reply' editor alone. [1.0.0]
	o Can set "SmilieMenu Total Smilies" for 'Quick Reply' editor alone. [1.0.0]
	o Can display SmilieBox under the editor rather than beside it. [1.0.0]
	o Can determine which width is better, the default message box width or the 100% extended width. [1.0.0]
	o Can "Display Cut/Copy/Paste Buttons" (On/Off). [1.5.0]
	o Can "Display Undo/Redo Buttons" (On/Off). [1.5.0]
	o Can "Display Extra Buttons" (On/Off). [1.5.0]
	o Can determine default "Message box Height". [1.5.0]
	o Can activate "Attachments" in quick reply. [1.5.0]
	o Can display "Thread Management Options" (On/Off). [1.5.0]
	o Can display "Disable Smilies option" (On/Off). [1.5.0]
	o Can "Hide Attachments' Extensions" (On/Off). [1.5.1]
	o Can "Hide Default Quick Reply Options" (On/Off). [1.5.1]
	o Can "Collapse Advanced Quick Reply by default" (On/Off). [2.0.0]
	o Usergroup permissions (per usergroup permission). [2.0.0]
	o Forum options (per forum option - On/Off). [2.0.0]
	o Excluding Users feature. [2.0.0]

   * Default Features:
	o Supported.
	o MD5 checked.
	o Fully phrased.
	o Optimized code.
	o Fully configurable from AdminCP.
	o Fully compatible with vBulletin 3.7.x series.
	o Will not alter environment of vb or any other products.
	o Primarily doesn't require any manual edits (Core functions).


Help Us:
   * With your brilliant suggestions and ideas to develop this product.
   * With your appreciated translations (translation credits go to their owners).
   * With your appreciated donation to keep this product free, premium and supported product.
     http://www.moneybookers.com
     Donations sent to: support [at] phpkd [dot] net By moneybookers.com


Known Isues:
   * None till now.


History:
   * v1.0.0 - 24/05/2008 07:07 AM (EEST): First initial public release.
   * v1.1.0 - 15/06/2008 07:07 AM (EEST): First update (private release).
   * v1.5.0 - 21/06/2008 06:00 AM (EEST): First public huge update.
	o Changes:
	   + Core:
		# Changing productid from "phpkd_full_quickreply" to "phpkd_aqr".
		# Changing product name from "Full Quick Reply" to "Advanced Quick Reply".
	   + Preferences:
		# Changing settinggroup location from 'under BBCode settings' to order '1005'.
	   + Settings:
		# "Smiliebox Smilies Per Row" value (3 -> 15).
		# "Smiliebox Below Editor" value (No -> Yes).
		# "Message box width" value (Default -> 100%).
	   + Phrases:
		# "Advanced Quick Reply BB Code Settings" -> "Advanced Quick Reply Settings".
	o New:
	   + General:
		# Optimizing smilies query (putting it inside if statment, if smilies are disabled then it won't be excuted).
		# Optimizing product's code as a whole.
		# Beautifying product's code & generate micro stats about product being installed.
		# Adding simple debugging tools to help resolve further problems by tracking product's info.
	   + Features:
		# Adding "Attachments in Quick Reply" with full support for all attachment's features in the full editor.
		# Ajaxifying all managment actions & doing all stuff on fly without reloading (changing phrases/images/option values on fly).
		# Adding Ajaxified "disable smilies in text" options.
		# Adding Ajaxified "Thread Management" options (open/close | stick/unstick).
		# On/Off "Display Cut/Copy/Paste Buttons" option.
		# On/Off "Display Undo/Redo Buttons" option.
		# On/Off "Display Extra Buttons" option.
		# Defaul "Message box Height" option.
   * v1.5.1 - 1/07/2008 09:00 PM (EEST): Public Maintenance Release.
	o Changes:
	   + Optimizing AJAX Code (And Fixing some bugs when some features are disabled).
	   + Disabling some features by default (Activation as normal from AminCP - We just turn it off by default but not terminating or deleting it). These features are [ Allow attachments / Display Thread Management Options / Display "Disable Smilies" option ].
	o New:
	   + Two new options [ Hide Attachments' Extensions (On/Off) / Hide Default Quick Reply Options (On/Off) ].
  * v2.0.0 - 26/07/2008 03:03 PM (EEST): Second public huge update (Second Generation).
	o Changes:
	   + Core:
		# Re-writing ~ the whole product's code.
		# Optimizing/fixing minnor bugs in the whole product's code.
		# Minimizing JavaScript file edits to just one tiny edit & separating all required JavaScript Code in a new compressed file.
	   + Preferences:
		# Changing settinggroup varname from 'phpkd_aqr_bbcode' to 'phpkd_aqr'.
	   + Settings:
		# Re-writing all boolean settings in a new manner depending on bitfields.
	   + Phrases:
		# Re-building all boolean settings related phrases.
	o New:
	   + General:
		# Adding md5 sum check.
		# Beautifying product's code.
		# Optimizing product's code as a whole.
		# Developing the debugging tools which help resolving problems by tracking product's info.
	   + Features:
		# Adding usergroup permissions (per usergroup on/off permission).
		# Adding forums permissions (per forum on/off switch).
		# Adding "Exclude Users" permissions (can exclude users from using product).
		# Adding "Collapse Advanced Quick Reply by default" feature.


Notes:
   1. Supported languages of this product are available as a translated products not as language files, the product's folder contains sub folders for languages, each one has the full package in that particular language (ie: English, Arabic ..).
   2. This product is supposed to work with vBulletin 3.5.x & 3.6.x series, but we don't support versions prior 3.7.x series, Just 3.7.x Stable series!
   3. Installing this product will automatically uninstall the first version of this product (1.0.x & 1.1.x series) with the different product ID ('phpkd_full_quickreply').


Files Tree:
   * Lang Name (i.e: English, Arabic ..)
	o import
	   + product-phpkd_aqr.xml
	o readme
	   + info.txt
	   + js.file.edit.php
	   + license.txt
	o screenshots
	   + Screenshots ...
	o upload
	   + clientscript
		# phpkd_aqr.js
	   + includes
		# md5_sums_phpkd_aqr.php
		# xml
		   * bitfield_phpkd_aqr.xml


Screen Shots:
   * Available in the "Screenshots" folder.


Technical Notes:
   * Plugins: 9
   * New Files: 3
   * File Edits: 1 JS
   * New Templates: 4
   * Template Edits: 0
   * Auo Template Edits: 11
   * New Database Tables: 0
   * Database Alterations: 2
   * New Phrases: 37
   * New Options: 9
   * Cron Jops: 0


Installation Procedure:
   * Upload the required files to it's appropriated places:
	o clientscript/phpkd_aqr.js
	o includes/md5_sums_phpkd_aqr.php
	o includes/xml/bitfield_phpkd_aqr.xml
   * Import the product file from your AdminCP (If upgrading "Allow Overwrite").
   * Caution: If you are going to activate any of the following options [ Attachments / Thread Management Tools / Disable Smilies Check box ] then you should do the following Required JS file edit. This JS file edit is Required Only if you are going to activate any of the mentioned options, otherwise you haven't to do it. This Edit Adds the AJAX functionality to process required actions dynamically on fly.
     [::-- Open js.file.edit.php file & do the edits descriped in it. --::]
   * Done.


Upgrade Procedure:
   * Un-do any previous file edits done for this product (It's better to restore the default vBulletin files).
   * Follow the installation procedure for this version.


Control:
   * AdminCP -> vBulletin options -> Advanced Quick Reply Settings
   * AdminCP -> Forums & Moderators -> Forum Manager -> Select Forum -> Enable / Disable Features -> Can use 'Advanced Quick Reply' (On/Off)
   * AdminCP -> Usergroups -> Usergroup Manager -> Select Usergroup -> Post / Thread Permissions -> Can use 'Advanced Quick Reply' (Yes/No)


At the end:
   * Thanks to all of you for supporting us by installing our products.


Other Mods:
   * Advanced Quick Edit - vB 3.7.x
     http://www.phpkd.net/forum/showthread.php?t=17

   * Periodic Prune Pms - vB 3.7.x
     http://www.phpkd.net/forum/showthread.php?t=2


Hint:
    * Please post your comments, suggestions, ideas for this product. We read all posts.
    * Make sure you click INSTALL:
      http://www.phpkd.net/forum/misc.php?do=mods&action=install&id=3
      You will be contacted when a new version is released.



Keep Moving Forward!

/*============================================================================*\
|| ########################################################################### ||
|| # Version: 2.0.0
|| # $Revision: 126 $
|| # Released: $Date: 2008-07-22 08:24:56 +0300 (Tue, 22 Jul 2008) $
|| ########################################################################### ||
\*============================================================================*/