Template:Auto-outdated

Revision as of 11:22, 20 July 2014 by Luccagenes (talk | contribs) (added another level to switch function to allow for a two year gap between the current and revision dates)

__NORICHEDITOR__

Auto-outdated ( Setpoint: 7 days )
Current alert status:  error2
Last Rev Date: 20  07  2014 (d/m/y)







Documentation:

The template is activated using {{Auto-outdated|14}} where “14” is the template parameter for the number of days from the last revision date before the template activates the “expired” condition (and installs the Category:Auto-outdated). The parameter value can be any integer number but the recommended values are 1 to 365 days.

The purpose of this template is to provide a means of automatically outdating an article based on a set number of days since its last revision date. This could be used on general articles by setting the Auto-outdated parameter to something like 365 days or 180 days. This would actually be most beneficial when used with more time sensitive articles (such as, Community News or WikiProject status) by setting the parameter to 7 days to ensure weekly updates.

Besides checking and displaying the Current Alert Status on the template display as either “OKAY” or “Expired” the template will also install a category (Category:Auto-outdated) when the parser functions trip the “Expired” notification. By routinely checking the above category, all instances of pages that have tripped the expiration date can be reviewed and corrected (resetting the “timer” by updating the article or at least checking it and performing a dummy save).

The parser functions compare the CURRENT TIME STAMP with the REVISION TIME STAMP based on the values using the day of the year value. Initially a check is performed to determine if the two years are equal so the difference of the values can be determined but if they are not, the days to the end of the previous year are added to the days in the current year. A third result (a two year gap) has been added to allow for set points up to 730 days although greater than 365 days is probably impracticable.

Technically the template parameter could be any number greater than zero but realistically should be limited from 1 to 365 days (as a three year span during the initial check will result in an error). Although this could be adjusted to include more than the current two year span it is not of a high priority since an article worth tagging with this template should be reviewed at least yearly and there is a possibility that more appropriate parser functions (such as “AgeParse”) may become available with newer versions of MediaWiki.

Also note that there is currently a 1 day error that will occur in leap years but this calculation is not a critical operation therefore this is not considered important and again, newer parser functions with newer versions of MediaWiki could correct this issue.