[wmtech] Rolling Message Counters - Manual, Instructions & Installation / Upgrade Guide

[wmtech]

Welcome to WMTech Quality Add-Ons!
We care about our products!
​

AUTOMATIC INSTALLATION INSTRUCTIONS:

We recommend the use of an automated installation and upgrade system.
Two of them are available for free to download at xenforo.com:

• Add-on Install & Upgrade by Chris D
• Install and Upgrade by Waindigo by Jon W **

Please try one of them!

** Note: If you use the product created by Waindigo, please enter the following line to your XenForo configuration file (/library/config.php ) to prevent any callbacks to Waindigo this add-on otherwise starts itself regularly:

$config['disableCallbacks'] = true

MANUAL INSTALLATION INSTRUCTIONS:

1. Download the add-on from our products section after licensing it for your forum(s). Please note, that we are enforcing our license. Please do not download, if you don't agree to it!
2. Upload everything from the "upload" directory in our software package into your web servers forum directory.
3. Install "addon-wmt_rollingmessagecount-1xx.xml" in your Xenforo ACP (ACP > Home > Install Add-On).
4. Access "ACP > Home > Options > [WMTech] Rolling Message Counter" to check and setup the options of this add-on.

Now you can enjoy our add-on at your board!

Special Installation Instructions (e.g. interactions with other add-ons):

• None so far.

UPGRADE INSTRUCTIONS:

1. Download the new version of the add-on from our products section after licensing it for your forum(s). You may need to relicense even free add-ons, if your last version is older than 6 months. Please note, that we are enforcing our license. Please do not download, if you don't agree to it!
2. Upload everything from the "upload" directory in our software package into your web servers forum directory overwriting all existing files with the new ones!
3. Go to your Xenforo "ACP > Home > List Add-Ons" and select "[WMTech] Rolling Message Counters". At the dropdown arrow on the right, choose "Upgrade Add-On". A pop-up appears and let you select the XML file "addon-wmt_rollingmessagecount-1xx.xml" we provide in the upgrade software package.
4. Access "ACP > Home > Options > [WMTech] Rolling Message Counter" to inspect existing options and setup any new options of this add-on.

This completes an upgrade process and refreshes your board with the enhanced power of a new version.

Special Upgrade Instructions:

• None so far.

ADMIN MANUAL:

Available Options in ACP:
Home > Options > [WMTech] Rolling Message Counter

• Rolling Message Count: Custom Days
  Choose and set for how many days you want to get messages of your users counted in addition to the non-configurable counters included in this add-on.
  IMPORTANT: If you change this option, the Custom Days Counter will be reset to 0.
  Default: 100
  
  
• Notable Members: Show Top Yearly Message Statistics ?
  Check this box, if you want to show the top Yearly Message Counter statistics to your visitors at the Notable Members page.
  Default: Checked
  
  
• Notable Members: Show Top This Month Message Statistics ?
  Check this box, if you want to show the top This Month Message Counter statistics to your visitors at the Notable Members page.
  Default: Checked
  
  
• Notable Members: Show Top Last Month Message Statistics ?
  Check this box, if you want to show the top Last Month Message Counter statistics to your visitors at the Notable Members page.
  Default: Checked
  
  
• Notable Members: Show Top 2nd Last Month Message Statistics ?
  Check this box, if you want to show the top 2nd Last Month Message Counter statistics to your visitors at the Notable Members page.
  Default: Checked
  
  
• Notable Members: Show Top Custom Days Message Statistics ?
  Check this box, if you want to show the top Custom Days Message Counter statistics to your visitors at the Notable Members page.
  Default: Checked

Available Administrator Actions in ACP:
Users > Edit User > Profile Info

• Messages This Month (Calendar)
  See or change the number of messages of this member, written within the current month.
  
  
• Messages Last Month (Calendar)
  See or change the number of messages of this member, written within the month before the current month.
  
  
• Messages Second To Last Month (Calendar)
  See or change the number of messages of this member, written within the second month before the current month.
  
  
• Messages 100 Days Back From Today
  See or change the number of messages of this member, written within 100 days before the current day.
  NOTE: This counter can be customized (see above). 100 days is just the default after installing this add-on.
  
  
• Messages 1 Year Back From Today
  See or change the number of messages of this member, written within 1 year before the current day.

Users > User Group Promotions > Create/Edit Promotion > Apply This Promotion While…

• User has posted at least X messages in current month
  Set a criteria on how many messages a user has posted within the current month
  
  
• User has posted no more than X messages in current month
  Set a criteria on how many messages a user has posted within the current month
  
  
• User has posted at least X messages in last month
  Set a criteria on how many messages a user has posted within the last month
  
  
• User has posted no more than X messages in last month
  Set a criteria on how many messages a user has posted within the last month
  
  
• User has posted at least X messages in second last month
  Set a criteria on how many messages a user has posted within the second last month
  
  
• User has posted at least X messages in last and second last month
  Set a criteria on how many messages a user has posted within the second last month
  
  
• User has posted at least X messages within last 1 year from today
  Set a criteria on how many messages a user has posted within the last year from today
  
  
• User has posted no more than X messages within last 1 year from today
  Set a criteria on how many messages a user has posted within the last year from today
  
  
• User has posted at least X messages within the last 100 days
  Set a criteria on how many messages a user has posted within the last 100 days from today
  NOTE: This counter can be customized (see above). 100 days is just the default after installing this add-on.
  
  
• User has posted no more than X messages within the last 100 days
  Set a criteria on how many messages a user has posted within the last 100 days from today
  NOTE: This counter can be customized (see above). 100 days is just the default after installing this add-on.

Appearance> Widget Framework > Add Widget
(only available if you have Widget Framework add-on installed)

• Renderer: User: Rolling Message Count
  The following Widgets are available (ascending and descending):
  • Message Count - Current Month
  • Message Count - Last Month
  • Message Count - Second Last Month
  • Message Count - Last Year from Today
  • Message Count - Past XX Days (configurable)

Available Permissions in ACP:
Users > Permissions > User Group Permissions
Users > Permissions > User Permissions

• There are no permissions for this add-on currently.

Available Phrases and Templates in ACP:
Appearance > Templates

• All public templates of this add-on start with "wmt_rmc_" The name of the templates is self-explanatory.

Appearance > Template Modifications

• This add-on uses template modifications instead of deprecated template hooks. All template modifications are VERY IMPORTANT for this add-on to be able to work. They are designed for the default style only! If you use any custom style, please check if all modifications have been applied correctly by looking at the numbers in the right column of the line with the modification name. If there is a grey or red number, the modification could not be applied thus making this add-on functionless. Contact us or your style designer to solve those issues!

Appearance > Phrases

• All phrases of this add-on start with "wmt_rmc_" The name of the phrases is self explanatory.

Development > Admin Templates (only available in "Debug Mode")

• All admin templates of this add-on start with "wmt_rmc_" The name of the templates is self-explanatory.

Development > Admin Template Mods (only available in "Debug Mode")

• This add-on uses admin template modifications. All template modifications are VERY IMPORTANT for this add-on to be able to work. They are designed for the default style of the admin control panel (ACP) only! If you use a custom style for the ACP, please check if all modifications have been applied correctly by looking at the numbers in the right column of the line with the modification name. If there is a grey or red number, the modification could not be applied thus making this add-on functionless. Contact us or your ACP style designer to solve those issues!

USER MANUAL:

This forum uses the "Rolling Message Counter" add-on from WMTech. As you write message in our discussion forums they are not longer counted only in a lifetime counter, but also in counters for your messages written in the current month, the past month and the second last month. There are also counters for the period of a year before the current day and the last 100 days.

You can see your counters at the profile page of your member account.

There are also statistics showing the top users for each of the counters at the "members" area page "Notable Members". Your forum admin however can choose not to show any of those statistics.

There may be user promotions setup by the admin of this forum with criteria provided by those counters.