Changes: Asphalt Wiki:New news item

Revision as of 12:08, 4 October 2019

This page is a how-to guide detailing a practice or process on Asphalt Wiki.

You've done that before? Go ahead:

As news can appear at different places on Asphalt Wiki, they are stored in a modular template system. Every news item has its own template which contains the relevant data. The Create news button above uses the name given in the input box to create a predefined template where you can fill in title, text, author (you) and categories.

When you click the button, you will be asked to specifiy a template type. Choose "Design". (Asphalt Wiki does not use this feature.)

Naming conventions

Every template is named

News YYYY-MM-DD ##

YYYY-MM-DD: Date of the news item. Month (MM) and day (DD) are always zero-padded, for example
2019-08-05.
##: Number of the news item on that day, two digits, zero-padded. The first item of a day has 01, the second 02, and so on.

This page automatically checks if previous numbers already exist and suggests the next possible number in the input box at the top.

This works up to 10. If 10 is suggested, editors should use the Check manually link to see if there are even more than 10 items in the News templates category for that day.
To add a news item of a past day, change the name in the input box manually.
If the Create news button leads to a template that is already filled with content, a template with this name already exists. Go back to this page and check manually for the next available number of that day.

When you are on the newly generated template page with a valid template name, copy the name without the "Template:" prefix to the templatename parameter. This is important because the date of the news item is calculated from this parameter as well as some other features.

Guidelines

Be responsible! Once you have published the template, your news item goes live immediately and will be visible on all news pages throughout the wiki.
Use of links:
- A news item should contain one link that leads to a page with further details, for example, the Update page if a new update is announced.
- Links in titles are ignored. Provide them in the text parameter.
- A link should be placed within the first 200 characters of the text parameter if you want it to remain visible in the compact news feed view where the text is cut off after 250 characters.
Categorization:
- ASPHALT 8 (a8 = 1): New Asphalt 8 updates, events, gameplay changes etc.
- ASPHALT 9 (a9 = 1): New Asphalt 9 updates, events, gameplay changes etc.
- STATISTICS (statistics = 1): Pro Kit Box changes, new studies, statistics topics etc.
- ASPHALT WIKI (wiki = 1): New wiki articles, new or changed wiki features
- EDITORS (editors = 1): New or changed wiki editing and coding features

Technical details

After you click the Publish button for the first time, the news will not be displayed correctly on the template page, and it will appear in all categories instead of the ones you have chosen. You always have to click the Edit button again and publish the template a second time.

@@ Line 1: / Line 1: @@
 {{how-to}}
+{|
-If you want to add a Pro Kit Box to Asphalt Wiki, you should consider not only to mention it on one page, but to fully integrate the box into the [[Help:Pro Kit Box modular system|modular system]]. This can be done by creating a template which contains all the relevant data on your Pro Kit Box.
+| style="vertical-align:top;" | You've done that before? Go ahead:
+| style="vertical-align:top;" |
-The advantage of creating a template: Pro Kit Boxes can appear at different occasions on Asphalt Wiki:
-* They can be mentioned in the flow of an article text, for instance: {{Champion Kit Box}}.
-* They can be listed in overviews like the [[Pro Kit Box]] article or in tables.
-* They can be used on Championship, R&D, and other event pages.
-If you find that some given information on your Pro Kit Box was incorrect or if the data changes (new [[drop rate]]s, for example), you would have to search the whole {{SITENAME}} for pages where your box is listed or mentioned—a procedure that means a lot of work and is highly error-prone. If templates are used, it is sufficient to change the data in the template, and all {{SITENAME}} pages will display the changes.
-There are predefined "half-ready" pages that help you. You can use the buttons below to go through the steps and follow the instructions given on the respective new page.
-== '''Template''' ==
-This special template is the "data container" for your Pro Kit Box. Before creating a template, you may want to check the [[:Category:Pro kit box templates|Pro kit box templates category]] if the template already exists. Editors can insert your box in an article by typing the box name surrounded by curly brackets <nowiki>{{ }}</nowiki> which will retrieve the data directly from the template you are creating now. Your template will also be used as a source for Pro Kit Box overviews. If you need to change the data of the box later, change this template.
-* Use the input box below to create a new template for your Pro Kit Box.
-* When you click the '''Create Pro Kit Box template''' button, you will be asked to specifiy a template type. Choose "Design".
-* On the new template page, change the parameters you want and click the '''Publish''' button. You do not have to fill in all box data now; you can do it later. Return to this page when you are done.
-* Follow the next step.
-{{PAGESINCATEGORY:News|pages}}
 <inputbox>
 type=create
-buttonlabel=Create news item
+buttonlabel=Create news
+width=20
 break=no
+default={{#ifexist:Template:News {{CURRENTYEAR}}-{{CURRENTMONTH}}-{{CURRENTDAY2}} 01
-default=News {{PAGESINCATEGORY:News|pages}}
+  |{{#ifexist:Template:News {{CURRENTYEAR}}-{{CURRENTMONTH}}-{{CURRENTDAY2}} 02
+    |{{#ifexist:Template:News {{CURRENTYEAR}}-{{CURRENTMONTH}}-{{CURRENTDAY2}} 03
+      |{{#ifexist:Template:News {{CURRENTYEAR}}-{{CURRENTMONTH}}-{{CURRENTDAY2}} 04
+        |{{#ifexist:Template:News {{CURRENTYEAR}}-{{CURRENTMONTH}}-{{CURRENTDAY2}} 05
+          |{{#ifexist:Template:News {{CURRENTYEAR}}-{{CURRENTMONTH}}-{{CURRENTDAY2}} 06
+            |{{#ifexist:Template:News {{CURRENTYEAR}}-{{CURRENTMONTH}}-{{CURRENTDAY2}} 07
+              |{{#ifexist:Template:News {{CURRENTYEAR}}-{{CURRENTMONTH}}-{{CURRENTDAY2}} 08
+                |{{#ifexist:Template:News {{CURRENTYEAR}}-{{CURRENTMONTH}}-{{CURRENTDAY2}} 09
+                  |News {{CURRENTYEAR}}-{{CURRENTMONTH}}-{{CURRENTDAY2}} 10
+                  |News {{CURRENTYEAR}}-{{CURRENTMONTH}}-{{CURRENTDAY2}} 09
+                }}
+                |News {{CURRENTYEAR}}-{{CURRENTMONTH}}-{{CURRENTDAY2}} 08
+              }}
+              |News {{CURRENTYEAR}}-{{CURRENTMONTH}}-{{CURRENTDAY2}} 07
+            }}
+            |News {{CURRENTYEAR}}-{{CURRENTMONTH}}-{{CURRENTDAY2}} 06
+          }}
+          |News {{CURRENTYEAR}}-{{CURRENTMONTH}}-{{CURRENTDAY2}} 05
+        }}
+        |News {{CURRENTYEAR}}-{{CURRENTMONTH}}-{{CURRENTDAY2}} 04
+      }}
+      |News {{CURRENTYEAR}}-{{CURRENTMONTH}}-{{CURRENTDAY2}} 03
+    }}
+    |News {{CURRENTYEAR}}-{{CURRENTMONTH}}-{{CURRENTDAY2}} 02
+  }}
+  |News {{CURRENTYEAR}}-{{CURRENTMONTH}}-{{CURRENTDAY2}} 01
+}}
 prefix=Template:
-preload=Template:New A8box
+preload=Template:New news item
 </inputbox>
+<small>[{{Purge|Refresh}}] &#91;[[:Category:News templates|Check manually]]]</small>
+|}
+As news can appear at different places on {{SITENAME}}, they are stored in a [[Help:News modular system|modular template system]]. Every news item has its own template which contains the relevant data. The ''Create news'' button above uses the name given in the input box to create a predefined template where you can fill in title, text, author (you) and categories.
-== '''Image''' ==
-If you don't provide an image for your box, a placeholder is shown. If you want to upload an image, you may first want to go to the [[:Category:Box images|Box images category]] to check if the file already exists. If so, you can simply add the filename to the <code>file</code> parameter.
+When you click the button, you will be asked to specifiy a template type. Choose "Design". ({{SITENAME}} does not use this feature.)
-If you want to upload your own image, please follow these rules:
-* The filename should be <code>A8box Name</code>, where <code>Name</code> is the exact name of the box as given in the game, for instance: <code>A8box Example Box.png</code>.
-* Do not use whole screenshots. The image will be mostly displayed as an icon, so it should at least be cropped. Transparent background is even better.
-* You can add the filename to the template prior to uploading the image. Thus, a red link is produced which you can click and easily upload the image.
-* Box images should be categorized. For example, the {{Super Split BP Box|style=inline}} has the following categories:
+== Naming conventions ==
-<pre>
+Every template is named
-[[Category:Purchasable box images|Super Split BP Box]]
+: <code> News YYYY-MM-DD ##</code>
-[[Category:Blueprint box images|Super Split BP Box]]
-[[Category:Split box images|Super Split BP Box]]
-[[Category:Asphalt 8 images|Super Split BP Box]]
-</pre>
+* <code>YYYY-MM-DD</code>: Date of the news item. Month (<code>MM</code>) and day (<code>DD</code>) are always zero-padded, for example<br><code>2019-08-05</code>.
-When adding a catetory, please add a pipe (|) followed by the name of the box without the prefix <code>A8box</code>. This prevents box images from being listed all under A which would make the category index letters useless. In the above example, the image will be listed under S instead.
+* <code>##</code>: Number of the news item on that day, two digits, zero-padded. The first item of a day has <code>01</code>, the second <code>02</code>, and so on.
+This page automatically checks if previous numbers already exist and suggests the next possible number in the input box at the top.
-For the same reason, leading item numbers as in the {{2-Mid-Tech Box|style=inline}} should be put at the end of the name like in the following example:
+* This works up to <code>10</code>. If <code>10</code> is suggested, editors should use the ''Check manually'' link to see if there are even more than 10 items in the News templates category for that day.
+* To add a news item of a past day, change the name in the input box manually.
+* If the ''Create news'' button leads to a template that is already filled with content, a template with this name already exists. Go back to this page and check manually for the next available number of that day.
+When you are on the newly generated template page with a valid template name, copy the name without the "Template:" prefix to the <code>templatename</code> parameter. This is important because the date of the news item is calculated from this parameter as well as some other features.
-<pre>
-[[Category:Tech box images|Mid-Tech Box 2]]
-[[Category:Asphalt 8 images|Mid-Tech Box 2]]
-</pre>
-== '''Article''' ==
+== Guidelines ==
-This is the main page for your Pro Kit Box. It contains the infobox and everything you want to write about the box.
+* Be responsible! Once you have published the template, your news item goes live immediately and will be visible on <!-- the {{SITENAME}} main page as well as--> all news pages throughout the wiki.
-* Use the input box below to create a new article for your Pro Kit Box.
+* Use of links:
-* This creates a predefined Pro Kit Box article. On the new page, replace the two appearances of <code>[Enter box name here]</code> in the first lines by the box name. Follow the other instructions and comments.
+** A news item should contain one link that leads to a page with further details, for example, the Update page if a new update is announced.
-* You can work on your article now or edit the infobox data in your new template.
+** Links in titles are ignored. Provide them in the <code>text</code> parameter.
-* Note: The infobox on your article page is only a different style of your box template. If you want to change infobox data, always do it in the template.
-* Setting the <code>article</code> parameter of the template to the article name will cause the box name to link to the article whereever the template is included. Example: <code> article = Example box</code>.
+** A link should be placed within the first 200 characters of the <code>text</code> parameter if you want it to remain visible in the compact news feed view where the text is cut off after 250 characters.
+* Categorization:
+** <span style="background:{{cc|bg a8}};">'''&nbsp;ASPHALT 8&nbsp;'''</span> (<code>a8 = 1</code>): New Asphalt 8 updates, events, gameplay changes etc.
+** <span style="background:{{cc|a9highlight}}; color:black;">'''&nbsp;ASPHALT 9&nbsp;'''</span> (<code>a9 = 1</code>): New Asphalt 9 updates, events, gameplay changes etc.
+** <span style="background:{{cc|bg statistics}}; ">'''&nbsp;STATISTICS&nbsp;'''</span> (<code>statistics = 1</code>): Pro Kit Box changes, new studies, statistics topics etc.
+** <span style="background:{{cc|bg wiki}}; color:black;">'''&nbsp;ASPHALT WIKI&nbsp;'''</span> (<code>wiki = 1</code>): New wiki articles, new or changed wiki features
+** <span style="background:grey; color:black;">'''&nbsp;EDITORS&nbsp;'''</span> (<code>editors = 1</code>): New or changed wiki editing and coding features
+== Technical details ==
-<inputbox>
+* After you click the '''Publish''' button for the first time, the news will not be displayed correctly on the template page, and it will appear in '''all''' categories instead of the ones you have chosen. You always have to click the '''Edit''' button again and publish the template a second time.
-type=create
-buttonlabel=Create Pro Kit Box article
-break=no
-placeholder=[Enter box name]
-preload=Template:New A8box article
-</inputbox>
-== '''See also''' ==
+== See also ==
-* [[Help:Pro Kit Box modular system]] – if you want to know more about how to use box templates in articles
+* [[Help:News modular system]] – if you want to know more about how to use news templates<!-- in articles-->
-* [[:Category:Pro kit box templates]] – the category for all box templates
+* [[:Category:News templates]] – the category for all news templates
-* [[:Category:Box images]] – the category for all box images
 [[Category:News| ]]