Template:License migration/doc
 | This is a documentation subpage for Template:License migration. It may contain usage information, categories and other content that is not part of the original template page. |
 | This template is used on approximately 45,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them. |
Description
[edit]This is the root of the "license migration" template system. By sending it an appropriate keyword it allows GFDL images to be automatically retagged and sorted into one of several categories based on whether the file is eligible to participate in the licensing update effort.
This template is intended to be appended to {{GFDL}} and similar templates that indicate a possibly eligible licensing status. A parameter will be added to {{GFDL}} that passes through the keyword used here allowing for calls to GFDL to take the new form {{GFDL|migration=keyword}}.
Templates transcluding {{license migration}} are automatically added to Category:Wikipedia license migration templates, and may have already been configured to pass through the migration= keyword.
Usage
[edit]The action taken depends on the keyword specified:
- Empty string or not recognized:
- An "announcement" highlighting the current relicensing effort is appended below the GFDL.
- relicense:
- This keyword should be used when a media file does meet the relicensing criteria. The {{cc-by-sa-3.0-migrated}} tag will be appended after the GFDL tag.
- not-eligible:
- This keyword should be used if the media file does not meet the relicensing criteria. It removes the notice and categorizes the image in Category:Wikipedia license migration not eligible.
- redundant:
- This keyword should be used if the media file is already dual licensed under CC BY 3.0 or CC BY-SA 3.0 and hence relicensing is not necessary. It removes the notice and categorizes the image in Category:Wikipedia license migration redundant.
- needs-review:
- This keyword should be used if cursory inspection of the image cannot determine whether it is eligible for relicensing or not. These images are categorized for further attention in Category:Wikipedia license migration needs review and the announcement message remains in place.
- opt-out:
- This keyword should only be used if the copyright holder for the image explicitly requests that they do not wish for this image to participate in the license migration. Doing this will remove the announcement and categorize the image in Category:Wikipedia license migration opt-out. Choosing to opt-out is discouraged, as it will generally make the material less reusable. The opt-out option will be available for a limited time only, and copyright holder wishing to exercise this option should act in an expeditious manner. For further discussion see Wikipedia:Image license migration#The opt-out provision.