Mini Mods - Email Reminder for inactive users

AS OF MARCH 16TH 2013 - THIS ADDON IS NO LONGER BEING UPDATED DUE TO INSUFFICIENT TIME AVAILABLE. THANK YOU ALL FOR USING THIS ADDON AND FOR YOUR SUPPORT. IF YOU OR YOU KNOW OF ANYONE THAT WOULD BE ABLE TO PICK UP WHERE I LEFT OFF ON THIS ADDON, PLEASE DO SO. I'M RELEASING THIS ADDON TO THE VBULLETIN COMMUNITY TO UPDATE AS NEEDED.
================================================== =======

What does it do?
=====================================
This mod will send out reminder emails to inactive members to encourage them to come back to your site.

I also want to give full credit and thanks to the developers of the previous versions from which this was derived:
technom8t (Email reminder for inactive users 1.0.0)
C Braithwaite and djbaxter (Email reminder for inactive users v1.2.7)
robertjandreu (Email reminder for inactive users 1.1.3)

*** See Updates section below for new feature list per release. ***

IF YOU HAVE QUESTIONS OR PROBLEMS WITH THE ADDON, PLEASE LET ME KNOW.

PLEASE DON'T FORGET TO CLICK THE INSTALLED LINK!! THANK YOU!!

Features
=====================================
* Turn product on/off.
* Set the number of days a user can be away from your site before being considered inactive. (Default: 30 days)
* Send reminder emails once and once only during any inactive period. (Default: Off)
* Edit maximum number of reminder emails sent totally.
* Set how often an reminder email is sent during an inactive period .
* Set reminder email format - TEXT or HTML.
* Set the reminder email subject. (phrased) (site must be placed in debug mode currently to edit, not translate)
* Set the reminder email body. (phrased) (site must be placed in debug mode currently to edit, not translate)
* Set the usergroups to be sent a reminder email.
* Set userids to exclude.
* Log inactive users that have been sent a reminder.

Install Instructions
--------------------------
This was written specifically for VB4. The VB3.8.x version is here.

IMPORTANT BEFORE YOU INSTALL, IF YOU HAVE A PREVIOUS VERSION INSTALLED I STRONGLY RECOMMEND THAT YOU BACK UP YOUR
CUSTOM REMINDER MESSAGE SUBJECT AND MESSAGE BODY THIS MOD WILL OVER WRITE THEM. ALSO, IN VERSION 2.x, REMINDER
MESSAGE CONTENTS HAS BEEN MOVED TO USING VBPHRASES. LOOK IN THE INSTALL.TXT FILE WITH THIS UPLOAD FOR A LIST OF
PHRASES USED IN THIS MOD.

1. Back up Custom Reminder Email Phrases that you have made.
2. Upload file in the upload folder to the forums folder on your server.
3. In your AdminCP:
a. If you've installed an older version of this mod prior to 1.1.4 you must uninstall it first as well as remove the files that came with it. I can not stress this enough.
b. Go to Plugs & Products -> Product Manager -> Add New Product.
c. Import the product xml from the zip file. (make sure to use overwrite)
4. The mod is disabled by default on install so you will need to enable it. Go to Vbulletin "Settings" -> Options -> Inactivity Reminder Emails.
5. Settings and the inactivity log viewer are also available on the left menu just above the users settings group.

History Log
=======================================
Update 2.2.1
* NEW : New plugin resets inactive members when they return to site.
* FIX : UserID field in inactivity log was showing 0, and UserID was not being added to the optout url.

UpDate 2.2.0
* CHANGE : Inactivity is now based on members Last Activity Date.
* ADD : Exporting the following additional values which can be used in reminder email templates. Check readme.txt in zip file for list of place holders.

Update 2.1.5
* CHANGE : Mod no longer has the option of adding a footer credit to the end of your website.
* CHANGE : Mod no longer has the option of adding a footer credit to outgoing emails.
* CHANGE : New Reminder Optout: Currently this is only accessable from emails being sent out.

Note: Please let members know that they may receive one more email at which time they can choose to optout/unsubscribe by clicking on the embedded link or copying/paste it into
their browser.

* FIX : Reminders were still being sent out incorrectly. I believe this is now fixed finally.
* FIX : Issues when emails were sent out had the incorrect "From" address and listed the host domain name. This should be resolved now.
* FIX : Issue regarding special characters in the usernames being added to the database has been resolve.
* NEW: New data fields have been implimented for keeping track of when reminders are sent out and how many a member has received. If you have a had this mod installed since version 1.1.4, it will look for those fields and rename them so you do not loose previous data in those fields, otherwise new fields will be added.
* NEW: I've added the ability to turn off the admin report. In this version, if it is enabled, you may receive 2 reports. One report for members that have never received a reminder and one for members who haven't received a reminder since the last reminder based on the frequencey setting in the mod settings screen.
* NEW: Reminder's sender and email address are correctly determined now. Should now reflect site name with the webmasteremail address as the reply to.
* CHANGE :Translations for 2.1.1 may not work for versions after since some templates and phrases have been removed.

Update 2.1.1 (6/24/2010) - German Translation - (Thanks Semmi)
Thanks to Semmi for translating the Admin menu, Phrases and Reminder Phrase Templates to German.

Update 2.1.1 (3/30/2010) - Bug Fix
* FIX - Removed extra where clause in query where scheduled task script was performing an update when inactive reminders where based on last post count.
* FIX - Email Phrase Templates - Changed $bburl variable to $forumurl to correct a broken unsubscribe link.
* NEW - Includes tool to reset the date and count of reminder emails that were previously sent to users. This tool is mainly for testing purposes.

Update 2.1.0 (3/26/2010) - Bug Fixs and some new features
* Edit number of emails send totally
* Choose whether inactivity is based on members "Last Post" or their "Last Activity"
* Keep a log of all inactive users contacted
* Opt-Out Feature for members - Include an opt-out link in reminder email. (Thanks to Gene Steinberg)
* Added a link to the bottom of the default email template phrases that members can use to unsubscribe from reminder emails.

Update 2.0.1 (03/15/2010 9:00pm) - Bug Fix
* FIX - Issue related to processing users in a batch configuration. Mod was checking for a field length greater than zero instead of a numeric value greater than zero.

Update 2.0.0 (03/15/2010) - Complete rewrite of mod
* NEW - Can specify number of users to process during nightly scheduled task.
* NEW - Send reminder emails in either text or html format.
* NEW - Email subject and message body uses vb phrase templates. I've included sample content in email phrase templates so all you need to is customize as desired.

Update 1.1.4 (03/05/2010) - Initial release for vBulletin 4.x
* FIX - Would continue to send out email more often than specified intervals due to incorrect setting in cron job.
* NEW - Exclude userids from processing.


IF YOU HAVE QUESTIONS OR PROBLEMS WITH THE ADDON, PLEASE LET ME KNOW. THOSE THAT HAVE NOT INDICATED THE MOD IS INSTALLED WILL BE A LOWER PRIORITY.

PLEASE DON'T FORGET TO CLICK THE INSTALLED LINK!! THANK YOU!!

PLEASE DON'T FORGET TO NOMINATE.

If you like this mod and it has helped your site, and would like to see more features added, please consider donating.
Your support is very much appreciated! Thank you - Thank you

[TalkVirginia]

How's the mod working for everyone? Any comments, questions, suggestions to add to my to-do list?

[Alibass]

Originally Posted by TalkVirginia

How's the mod working for everyone? Any comments, questions, suggestions to add to my to-do list?

Mod is working as it should, but seems to be a bug on the email report. It says that emails were invalid but they were sent and received.

This email shows that the product is installed and working as it should be.


Emails sent to: Test Member


We tried to email the following users, but their email address was invalid:

[TalkVirginia]

Originally Posted by Alibass

Mod is working as it should, but seems to be a bug on the email report. It says that emails were invalid but they were sent and received.

This email shows that the product is installed and working as it should be.


Emails sent to: Test Member


We tried to email the following users, but their email address was invalid:

I'm 99.9% certain that's what you should be receiving. I'll double check the code, but if there were any users that had invalid email addresses and could not send email to, they would have shown up below the last line. If you enter a bad email address for that test user, one that you know will fail, that report will tell you.

[TalkVirginia]

While reviewing the code this evening, I did come across one issue so far related to processing inactive users in a batch configuration. According to the description:

How many users to process during each scheduled task? (0 for unlimited)

I was originally testing for a blank field or zero length input in this field when it should have been checking for a value greater than zero (0). This has been corrected and I'm attaching the new fix. Drop it into your /forumroot/includes/cron folder and you will be set. I will update the zip file with the fix as well and increment the version count.

[djbaxter]

Originally Posted by Alibass

Mod is working as it should, but seems to be a bug on the email report. It says that emails were invalid but they were sent and received.

This email shows that the product is installed and working as it should be.


Emails sent to: Test Member


We tried to email the following users, but their email address was invalid:

That's the way it is designed. if no email addresses or member names are listed after "We tried to email the following users, but their email address was invalid:", it means that no invalid email addresses were found.

[insidedesign]

I uploaded the files and the xml product, but the version still lists 2.0.0 - is this on my end or with the plugin?

Also, what happens when you install this on a vbulletin website that already has tens of 1,000s of members? I assume I have 1,000s of members with last action dates well past due for a reminder email. How are these handled?

[Sadikb]

Hi, Installed and Working fine.

There is one problem however. In the emails that this product sends, it uses the hostname in the email header for "mailed-by" and also in the from field it appends the Host domain name. Can we change that to use our own domain name instead of the host's domain name?

Thanks

[TalkVirginia]

Originally Posted by insidedesign

I uploaded the files and the xml product, but the version still lists 2.0.0 - is this on my end or with the plugin?

Thanks for pointing this out. I'm still learning about the product packaging. I can update the version on the product xml file however my original thinking was that since there was not an issue in the product xml I'd leave that as 2.0.0. The last fix was in the reminderemail.php.

Originally Posted by insidedesign

Also, what happens when you install this on a vbulletin website that already has tens of 1,000s of members? I assume I have 1,000s of members with last action dates well past due for a reminder email. How are these handled?

Change the value in Number of users to process during each scheduled task

[TalkVirginia]

Originally Posted by Sadikb

Hi, Installed and Working fine.

There is one problem however. In the emails that this product sends, it uses the hostname in the email header for "mailed-by" and also in the from field it appends the Host domain name. Can we change that to use our own domain name instead of the host's domain name?

Thanks

I should be able to do that. If you can you post an example header of what you are referring to and I'll look into it.

[insidedesign]

Originally Posted by TalkVirginia

Thanks for pointing this out. I'm still learning about the product packaging. I can update the version on the product xml file however my original thinking was that since there was not an issue in the product xml I'd leave that as 2.0.0. The last fix was in the reminderemail.php.



Change the value in Number of users to process during each scheduled task

So should this number be equal or greater than the number of members a website has? Sorry, just trying to get a good understanding...