Quote Post in PM for vbb 4

[Admin]

Quote Post in PM

=================
Info:
=================

This product adds a new option in user's popup menu "Quote this post in PM" with the new URL having the title attribute "Quote this post in PM to *username*".
This option passes to new personal message (PM): post's text, username of the post, post id, as well as the post title (if there is one), or thread title (if there is no post title).
It can also add image-link to 'postbit' and 'postbit_legacy' templates.
And even replace in popup menu the URL and the phrase for option "Private Message" with its own URL and phrase.

Futures of this hack:

• There is option to enable/disable hack.
• The hack is fully translatable.
• The hack can update popup menu automatically using hook $template_hook[memberaction_dropdown_items]. You can disable this one.
• The hack can update 'postbit' and 'postbit_legacy' templates automatically using hook $template_hook[postbit_controls]. You can disable this one.
• The hack can replace in popup menu the URL and/or the phrase for "Private Message" option with its own URL and/or phrase.
• The hack uses its own template "qpipm_quote". You can change it as you like. The variables: "$originalposterandpostid", "$originalposter", "$originalpostid" and "$pagetext" can be used in that template.
• There is option "Automatically Quote Post / Thread Title". Setting this to "Yes" will automatically fill the title of new PM with either the thread or the parent post title, prefixed by 'Re: '.
• You can change 'Re: ' for both threads' and posts' PMs. Search for phrases 'qpipm_re_thread' and 'qpipm_re_post'.
• You can insert the template of this hack manually anywhere you want in user's popup menu by using "{vb:raw qpipm}". Read "Notes:" below.
• You can insert the template of this hack manually anywhere you want in postbit by using "{vb:raw qpipm_postbit}". Read "Notes:" below.
• You can translate this hack into your native language. Search for Phrases Containing "qpipm_".
• You can set your own PM's title for both threads' and posts' PMs. Search for phrases 'qpipm_own_title_thread' and 'qpipm_own_title_post'.
• Option "Use Post's Number in PM's Title". Setting this to "Yes" will use post's number instead of thread's or post's title in PM's title field where available.
• Option "Use Thread's Title even if there is Post's Title". Setting this to "Yes" will always fill the new PM's title field with thread's title, even if there is post's title.
• Option "Trim Post's Text" allows you to trim the post's text been quoted to new PM.
• And other great options.

Use this version only with vBulletin 4.0.2 or greater.

Enjoy!

=================
Installation:
=================

Install the product

=================
Administration:
=================

To set up the products options go to: AdminCP > vBulletin Options > Quote Post in PM
Make translation of phrases containing "qpipm_"

=================
Greetings:
=================

A special thanks goes out to Dismounted for helping me with hook $template_hook[postbit_user_popup] problems. (http://www.vbulletin.org/forum/showthread.php?t=150769)
Thanks go to Abe1 for his comments. (http://www.vbulletin.org/forum/showthread.php?t=150769)
Thanks goes to amykhar for his original 'Quote Post in PM' hack idea.
Thanks goes to cellarius for his how to thread. (http://www.vbulletin.org/forum/showthread.php?t=228078)

=================
Notes:
=================

1.
If you want to change some phrases with strings like {1} or {2} then you can find some useful information in file "Read_Me - FAQ - Language strings values.txt"

2.
If you want to insert this hack in templates manually here is an example how you can make it:

***************
For popup menu
***************
1.
Go to "AdminCP > vBulletin Options > Quote Post in PM"
Set "Update Popup Menu Automatically" to "No".

2.
Open Template:

• memberaction_dropdown

Find (for example):

<vb:if condition="$show['pmlink']">

        <li class="left">            <img src="{vb:stylevar imgdir_siteicons}/message.png" alt="" />            <a href="private.php?{vb:raw session.sessionurl}do=newpm&amp;u={vb:raw memberinfo.userid}" rel='nofollow'>                {vb:rawphrase private_message}            </a>        </li>        </vb:if>

Add After:

[LEFT]{vb:raw qpipm}[/LEFT]

****************************************
For postbit and postbit_legacy templates
****************************************
1.
Go to "AdminCP > vBulletin Options > Quote Post in PM"
Set "Update Postbit Automatically" to "No".

2.
Open Templates: (Note: there are two different templates to open!)

• postbit
• postbit_legacy

Find (for example):

[LEFT]{vb:raw post.iplogged}[/LEFT]

Add Before:

[LEFT]{vb:raw qpipm_postbit}[/LEFT]

=================
History:
=================

v3.7.100 - 02.07.2007
- First release

v3.7.101 - 01.08.2007
- Just removed the code which is not needed any more if you have vBulletin 3.6.8 or greater

v3.7.102 - 17.09.2007
- Made phrase "qpipm_quote_post_in_pm" more comfortable for translation
- Fixed template "qpipm_menu"

v3.7.103 - 29.04.2008
- Compatible with vBulletin 3.7 Gold (may not work with Beta/RC releases)
- New options "USERGROUPS can use quote", "USERGROUPS not allowed to use quote", "USERS not allowed to use quote"
- New variable "$originalposterandpostid" introduced - it is returned with post number in it
- vBulletin function fetch_quote_username() is used now in generating user's name in variable "$originalposterandpostid"
- vBulletin function fetch_quote_username() is used now in generating user's name in variable "$originalposter"
- Variables "$originalposter" and "$originalpostid" was removed from template "qpipm_quote" but you can still use them there if you want

v3.7.104 - 01.05.2008
- New option "Automatically Add Title" allows you to switch quoted PM's title at all
- New option "Always Use Thread's Title"
- Option "Automatically Add Prefix To Title" was separated
- From this version the product doesn't use some Boofo's copyrighted code without his permission

v3.8.105 - 08.03.2009
- Compatible with vBulletin 3.8 Gold (may not work with Beta/RC releases)
- All Templates are cached now
- The image-link can be inserted in postbit and postbit_legacy templates automatically
- You can use your own titles for threads' and posts' PMs
- You can set your own PM's title for both threads' and posts' PMs
- New option "Use Post's Number in PM's Title"
- New option "Use Thread's Title even if there is Post's Title"

v3.8.106 - 05.08.2009
- New option "Replace URL "Send a private message to" in Popup Menu"
- New option "Replace Phrase "Send a private message to" in Popup Menu"
- Added ' rel="nofollow"' to templates "qpipm_menu" and "qpipm_postbit" to follow vBulletin standard
- Fixed some phrases for settings

v4.0.100 - 10.01.2010
- Compatible with vBulletin 4.0.0 Gold

v4.0.102 - 02.03.2010
- Compatible with vBulletin 4.0.2 and above only
- New option "Use Left Popup Menu Column"
- Added one new phrase
- Updated some phrases

v4.0.103 - 03.03.2010
- Fixed PHP Warning: Unexpected character in input: '\\' (ASCII=92)
- Fixed option "Replace URL "Private Message" in Popup Menu" putting the same post number in every Popup Menu
- Added check that option "Replace URL "Private Message" will only work if the option "Update Popup Menu Automatically" is disabled!

v4.0.104 - 04.03.2010
- New option "Trim Post's Text"
- Fixed PHP Warning: fetch_template() calls should be replaced by the vB_Template class.
- Fixed PHP Warning: array_merge() [function.array-merge]: Argument #1 is not an array
- Old variables for template "qpipm_quote" replaced by new variables: "{vb:raw qpipm_originalposterandpostid}", "{vb:raw qpipm_originalposter}", "{vb:raw qpipm_originalpostid}" and "{vb:raw qpipm_pagetext}"
- Added one new phrase
- Updated some phrases

v4.0.105 - 18.10.2010
- Fixed plugin "Quote Post in PM (1)" (Thanks to Vitaly - post #2104969) - affected forums where option "Update Postbit Automatically" was set to "No" and option "Replace URL "Private Message" in Popup Menu" was set to "Yes".
- Replaced deprecated function split() with explode() function
- Updated template "qpipm_menu" to watch changes in latest revision of template "memberaction_dropdown"

v4.0.106 - 24.12.2010
- Updated dependency to 4.1.99
- Tested on Version 4.1.0 Patch Level 2
- Updated manually installation instruction

=================
How to Update:
=================

v4.0.105 -> v4.0.106
- No update needed

v4.0.104 -> v4.0.106
- Import the product
- Revert template "qpipm_menu" if you changed it
- Update phrases

v4.*.* -> Latest One
- Import the product
- Revert templates "qpipm_menu", "qpipm_postbit", "qpipm_quote" if you changed them
- Update phrases

Any Old One -> Latest One
- Write down your settings for this product in "AdminCP > vBulletin Options > Quote Post in PM"
- Uninstall old version
- Import the product
- Set your settings back

=================
Other versions of modification:
=================



Download Now
Quote_Post_in_PM_v4-0-106.zip