Portal:Association football/Instructions/Advanced
This page gives Advanced instructions for users who wish to know how Portal:Association football works and what each template does.
Sections
[edit]Top
[edit]The majority of the Top section is the same across all Portal tabbed pages. The elements are as follows -
The {{browsebar}}
displays the main Portal categories, as per the Portal Manual of Style - this should appear at the top of each page.
The {{Sports portal browsebar}}
displays the child portals of Portal:Sports and games - this should appear at the top of each page.
{{Portal:Association football/Tabs}}
produces the tab-page element. Each page has its own /Tabs page to highlight the currently viewed page. These are located at Portal:Association football/Tabs, Portal:Association football/Categories and Main topics/Tabs and Portal:Association football/Projects and Things/Tabs.
{| width="100%" cellpadding="5" cellspacing="5" style="background:#f0fff0; border-style:solid; border-width:1px; border-color: #ADDFAD; border-top:0;"
| valign="top" style="padding: 0; margin:0;" |
is the table style for the whole portal. Here the colours of the portal are defined. border-top:0;
ensures that there is no top border for the best tab display.
Content
[edit]All content is either called from a static page or is displayed randomly from a pre-configured selection.
Static
[edit]Static content elements take the form -
{{/box-header|The Association football Portal|Portal:Association football/Header|}}
{{Portal:Association football/Header}}
{{/box-footer|}}
{{/box-header}}
is the template that controls the appearance of the top of each displayed box. Different colours can be set by editing Portal:Association football/box-header. {{/box-footer}}
is the template that controls the appearance of the bottom of the box including any "read more" links. It can be edited at Portal:Association football/box-footer.
Boxes are constructed as below -
{{/box-header| 1 | 2 }} {{ 3 }} {{/box-footer| 4 }}
Where -
- is the Title of the box as displayed on the portal
- is the name of the page users are sent to when clicking on edit, you can leave this out if you want but you must keep the pipe (|) or the template will break
- is the actual content to be displayed
- is a wikilink to an archive or a link in the form of [[Football (soccer)|Read more..]]. Again, this can be left out but you must keep the pipe character.
Random
[edit]Random content is displayed using Template:random portal component. This calls a random sub-article from a list and takes the form below -
{{Random portal component|max=25|seed=29|header=Selected article|subpage=Selected article}}
Where -
- max=25 - tells the component that the maximum amount of sub-pages to choose from is 25
- seed=29 - gives the component its value for randomness this should be different for every use of this template to stop it displaying the same articles together too often
- header= - the displayed box Title
- subpage= - the subpage where the list of articles is located
The template will automatically use the values from box-header and box-footer when it chooses new content.
When using any random element the following code should be added to a page -
<div style="text-align:center; margin:-7px; padding-bottom:12px;">{{purge|'''Show new selections'''}}</div>
This generates the following -
Clicking this link purges the pages cache and shows new random selections.
Columns
[edit]Columns are created with the following code -
<div class="portal-column-left-wide"> ...left column content... </div> <div class="portal-column-right-narrow"> ...right column content... </div>
The two values when added together should equal 99%, this is to keep the columns inside the main portal border. Column widths are important when considering viewers on screen resolutions of 800x600, 60% is the minimum column width that allows those users to view the Selected picture box without it breaking out of its border.
Anything after the final </div>
will display across the page and not in a column.
Bottom
[edit]The bottom of the main portal page uses the following -
<nowiki> <div style="width:100%"> {{portals}} <center><small>{{purge|''Purge page cache''}}</small></center></div></nowiki
This is only necessary for the main page, other tabs only need {{portals}}
placed on them at the bottom as per the MoS.