Private Messages Enhancements - Quote Post in PM

Quote Post in PM

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

This product adds a new option in user's popup menu "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 "Send a private message to *username*" with its own 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[postbit_user_popup]. 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 the phrase for "Send a private message to" option with its own.
• The hack uses its own template "qpipm_quote". You can change it as you like. The variables: "$originalposterandpostid", "$originalposter", "$originalpostid" and "$pagetext" are 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 "$qpipm". Read "Notes:" below.
• You can insert the template of this hack manually anywhere you want in postbit by using "$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 avaliable.
• 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 3.8.0 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. (https://vborg.vbsupport.ru/showthread.php?t=150769)
Thanks go to Abe1 for his comments. (https://vborg.vbsupport.ru/showthread.php?t=150769)
Thanks goes to amykhar for his original 'Quote Post in PM' hack idea.

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

1.
If you want to change some phrases with strings like {1} 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:

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

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

• postbit
• postbit_legacy

Find (for example):

	<if condition="$show['pmlink']">
		<tr><td class="vbmenu_option"><a href="private.php?$session[sessionurl]do=newpm&amp;u=$post[userid]" rel="nofollow"><phrase 1="$post[username]">$vbphrase[send_private_message_to_x]</phrase></a></td></tr>
	</if>

Add After:

	$qpipm

****************************************
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:

		<!-- / controls -->

Add Before:

		$qpipm_postbit

=================
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

v3.8.107 - 04.03.2010
- New option "Trim Post's Text"
- Added check that option "Replace URL "Private Message" will only work if the option "Update Popup Menu Automatically" is disabled!
- Added one new phrase
- Updated some phrases

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

v3.8.106 -> v3.8.107
- Import the product
- Revert template "qpipm_quote" if you changed it
- 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

=================
Mark as Installed:
=================

Click Mark as Installed to get an email when an update is released!

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

• [4.0.x] Quote Post in PM
• [3.7.x] Quote Post in PM
• [3.6.x] Quote Post in PM

[Makc666]

Really you can use this one with 3.7.x and 3.6.8+

To do so you have to:

• Open *.xml file.
  
• Find:
  
  PHP Code:

          <dependency dependencytype="vbulletin" minversion="3.8.0" maxversion="3.8.99" /> 

• Replace with:
  
  PHP Code:

          <dependency dependencytype="vbulletin" minversion="3.6.8" maxversion="3.8.99" /> 


[vithorius]

PERFECT!!! :up:

I was just looking for this hack for soooo long...!


(I mean, I prefer the button instead of the popup menu...!

JUST PERFECT! :up: :up:

[Fungsten]

I'm getting the double in the popup menu. Yes I did check the templates for $qpipm_postbit, and $qpipm and they were not there. TIA.

On Edit:

Both the pervious version and this new version were installed. So, this product does not write over the old version rather it add this version.

[Sworm]

Hi,
i'm using on 3.81 your previous version,
for the upgrade, i have need to uninstall the previous one or i can upgrade simply over the old one from Admincp/product & plugin than adding the check on "overwrite"?

[Makc666]

Originally Posted by Fungsten

I'm getting the double in the popup menu. Yes I did check the templates for $qpipm_postbit, and $qpipm and they were not there. TIA.

On Edit:

Both the pervious version and this new version were installed. So, this product does not write over the old version rather it add this version.

Fungsten, yes, I know.
I decided not to implement auto uninstall of old version for this product for some reasons.

Originally Posted by Sworm

Hi,
i'm using on 3.81 your previous version,
for the upgrade, i have need to uninstall the previous one or i can upgrade simply over the old one from Admincp/product & plugin than adding the check on "overwrite"?

Sworm, yes, just read the note below and uninstall old one, but don't forget to write down you settings for this product.

That is why I wrote in the first post:
=================
How to Update:
=================

Any version -> v3.8.105

• 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

[Sworm]

Thanks , i try to Uninstall and install the new one.

[Fungsten]

Originally Posted by Makc666

Fungsten, yes, I know.
I decided not to implement auto uninstall of old version for this product for some reasons.

I think a good idea would also be to first install the upgrade then uninstall the older version. Usually with uninstalls all the settings get erased then everything has to be reset.

[ahmed-samara]

good work man .. also i see this hack in ASP forums for a long time and i hoped to see in vBulletin

thanks too much

[Jasem]

good work, thank you

installed