==README for Time Ago add-on for miniBB==
Release date: February 17, 2016
Most recent update: June 19, 2018
miniBB version: 3.3 and higher
Author: Paul Puzyrev (minibb.com)

This quick addition will set to display all dates in so called "Time Ago" format, which is widely used by social networks and blog software. Instead of the regular straight timestamp, forum dates will be displayed as for example, "3 minutes ago", "5 hours ago", "1 day ago" or "2 days ago". There are additional calculations involved in this process, and after installing the add-on you may need to watch your forums, making sure there is not significant loss in speed.

==INSTALLATION==

Open bb_plugins.code.txt file in a text editor. 

Copy the code and paste it into your forum's bb_plugins.php (found in /forums). 

The code could be either preferrably at the top of the file, right after the opening '<?php' tag, or before any add-on's code which is not interuptive to the execution.

==SETUP and CONFIGURATION==

You could configure naming of the date/time periods, setting up the variable named $l_backLessTimes in your language pack (lang/eng.php or whatever). This variable should be the array in the following format (if it's not set, default code from bb_plugins.php's function will be used):

$l_backLessTimes=array(
2=>'Just&nbsp;now',
60=>'&lt;&nbsp;{X}&nbsp;sec{s}',
3600=>'&lt;&nbsp;{X}&nbsp;min{s}',
86400=>'&lt;&nbsp;{X}&nbsp;hr{s}',
172800=>'&lt;&nbsp;1&nbsp;day',
253800=>'&lt;&nbsp;2&nbsp;days',
);

The array's index indicates the amount of seconds went prior to the record was made. If the period went is bigger than then biggest value in this array, the script will display the default date and time, which format is set under setup_options.php -> $dateOnlyFormat, $timeOnlyFormat and $dateFormat options. 

{X} value will be substituted to the proper amount of resp. seconds, minutes, or hours - make sure to leave this fragment in all of your modifications; {s} is substituted to the "s" ending in English words accordingly to the amount, or an empty value. 

Keep in mind that these definitions could be used for the Responsive/Mobile template as well, where appearance of the date is quite limited in space. That's why, take care to provide these descriptions as short as possible.

If you need more precise modifications for certain non-English languages, try to modify the function `convert_date_back` of bb_plugins.php, or refer to our support:

- on miniBB forums - free - http://www.minibb.com/forums/

- privately - following our regular Premium support rates - http://www.minibb.com/contacts.html


THAT's ALL!

To uninstall the plugin, just undo changes made from the steps above.

Please, post bugs and suggestions on our forums:
http://www.minibb.com/forums/
