5.0.2 Overview
Replace date tags within your content items with formatted date strings that count up or down to the specified date. Prefix and suffix based on past or future dates. Date range restrictions, and more.
Use the plugin configuration to set defaults, such as standard output length (how many units of measure to display) as well as default suffixes and prefixes for both past and future dates.
Within each plugin tag, you can specify if the tag is to display only within a specific date or time range. All dates can be entered using standard PHP Time, Date, Compound, or Relative Format.
Installation
- Download EXTENSIONNAME from the RicheyWeb download page.
- This page will remain unlinked, as the link may change in the future. Visit http://www.richeyweb.com and use the search feature - search for "EXTENSIONNAME".
- In Joomla /administrator, go to the "Extensions" menu, the "Manage" sub-menu, and the "Install" sub-menu.
- Select the "Upload Package File" tab
- Press the "Choose File" button to browse your system and locate the plugin file you downloaded
- Press the "Upload & Install" button
At this point, the extension is installed but not enabled. You can find the plugin by going to the Extensions menu and selecting "Plugins". When in the plugin manager, search for "EXTENSIONNAME".
Configuration
Instructions:
- Parameter Types:
- length
- Value: Integer - can be a quoted or unquoted integer between 1 and 6. Values above 6 are ignored.
- Sets the number of values to display. For example, if set to 2 and the result is 1 year, 1 month, 1 day, 1 hour, 1 minute - the output would be 1 year and 1 month.
- Overrides Number of Elements option in the plugin basic settings.
- Example: 1 day and 4 hours from now
- pastfuture
- Value: Boolean - can be a quoted or unquoted 1 or 0. Any value other than 0 is considered true.
- Enables/Disables the default suffix for the output. If in the past - the output is followed by ago, if in the future - the output is followed by from now.
- Overrides Past/Future Suffix option in the plugin basic settings.
- Example: 1 day and 4 hours from now
- pastprefix
- Value: String - Must be quoted unless it is a single word containing no spaces.
- String to prepend to the output if the date is in the past.
- Overrides Past Prefix option in the plugin basic settings.
- Example: A long time ago, 19 hours and 6 minutes ago
- pastsuffix
- Value: String - Must be quoted unless it is a single word containing no spaces.
- String to apppend to the output if the date is in the past.
- Overrides Past Suffix option in the plugin basic settings.
- Example: 19 hours and 6 minutes ago - in a galaxy far, far away.
- futureprefix
- Value: String - Must be quoted unless it is a single word containing no spaces.
- String to prepend to the output if the date is in the future.
- Overrides Future Prefix option in the plugin basic settings.
- Example: Sometime in the near future, maybe in 1 day and 4 hours from now
- futuresuffix
- Value: String - Must be quoted unless it is a single word containing no spaces.
- String to apppend to the output if the date is in the future.
- Overrides Future Suffix option in the plugin basic settings.
- Example: 1 day and 4 hours from now, I plan on having lunch.
- before & after
- Values: date strings - Any date format accepted in the valid date formats below. Be sure that your between value is a date or time before your and value.
- Display only if the current date/time is before/after or between these two values. Can be used individually, or together.
- Example:
- length
- Valid Date Formats:
- Any valid Time Format
- Any valid Date Format
- Any valid Compound Format
- Any valid Relative Format
- Just for fun:
- Michael Richey is 51 years ago old. Yikes!
- Simon Richey is 17 years ago old. Wow!
- 9 hours and 53 minutes from now it will re-open in 1 day and 53 minutes from nowThe store will close in 9 hours and 53 minutes from now
- The United States Declaration of Independence 248 years ago