Template:AM/doc View history

(typo)
 
(44 intermediate revisions by 6 users not shown)
Line 6: Line 6:
The following subpages are used to build an Area Manager table.
The following subpages are used to build an Area Manager table.


* {{tl|AM/Top}} - Top of the template
* {{tl|AM/Top}} - Top of the template: controls column headings/widths and top colors; also automatically includes the Regional Coordinators.
* {{tl|AM/6}} - Rank 6 (Country Managers) heading with optional State Name as first parameter
* {{tl|AM/Country}} - Country Managers heading with optional State Name as first parameter
* {{tl|AM/5}} - Rank 5 (Area Managers) heading with optional State Name as first parameter
* {{tl|AM/State}} - Statewide Area Managers heading with optional State Name as first parameter
* {{tl|AM/4}} - Rank 4 (Area Managers) heading
* {{tl|AM/Area}} - Area Managers heading
* {{tl|AM/3}} - Rank 3 (Area Managers) heading
* {{tl|AM/AreaLink}} - Area Managers heading w/link to edit <small><code><nowiki>{{{{RootPage}}/AM/Editor/Area}}</nowiki></code></small>
* {{tl|AM/Area2Link}} - Other Area manager table heading w/link to edit <small><code><nowiki>{{{{RootPage}}/AM/Editor/Area2}}</nowiki></code></small>
* {{tl|AM/Bottom}} - Bottom the the template
* {{tl|AM/Bottom}} - Bottom the the template
* {{tl|AM/Colspan}} - Variable used to span columns for headers
* {{tl|AM/Colspan}} - Variable used to span columns for headers
* {{tl|AM/Editor}} - Area/Country Manager template
* {{tl|AM/Editor}} - Area/Country Manager template
* {{tl|AM/Badge}} - Badges for Area Manager table with color coding; details below
The automatic pagename elements in the table uses {{tl|RootPage2}} to ensure the correct pagename is determined, so the template must be built on a page that has a valid state or territory (or USA) as the base pagename.
Valid examples:
* USA/CommonState
* Arizona
* Arizona/Test
* Puerto Rico
=== AM/Top ===
When using the AM table to also display Google Hangouts avatars, and display names, you can modify the header row accordingly.
The {{Tl|AM/Top}} accepts two ''optional'' named parameters, which modify it to support GHO avatars and names.
*{{para|gho|yes}} = Will add a new line under "Username" with a Google Hangouts lookalike icon, and the default text "GHO Display Name".
*{{para|ghoName|DISPLAY TEXT}} = Can be used to change the default text shown next to the icon. This is only applied if {{para|gho|yes}} is also used.
For example {{tlx|AM/Top|gho{{=}}yes}} will produce:
{{AM/TopExample|gho=yes}}
{{AM/Editor|GoogleMapMakerKing|6|Statewide|Silicon Valley, Mountainview, New York|badge1=gc|gho=Royal GMM}}
{{AM/Bottom}}
For a custom text {{tlx|AM/Top|gho{{=}}yes|ghoName{{=}}Nickname}} will produce:
{{AM/TopExample|gho=yes|ghoName=Nickname}}
{{AM/Bottom}}
=== AM/Editor ===
The {{tlx|AM/Editor}} has four unnamed parameters in the following order:
* Editor name
* Editor rank
* Area Managed
* Comments
Any field (besides the Editor name) can be skipped, but the pipe character must be present.
There are two '''optional''' named parameters for displaying a Google Hangout avatar, and nickname.
* {{Para|gho|GHO DISPLAY NAME}} - When used it will display this name in gray on a new line below the username. It can be placed after the comments or badge parameters.
* {{Para|pic|File:Avatar USERNAME.png}} - When used will display the image you provide to the left of your GHO name. If not used a default Google style color tile with your initial will be shown instead.
Example:
{{Pre2|<nowiki>{{AM/Editor|WazingTime||Statewide|}}</nowiki>}}
Produces:
{{AM/TopExample}}
{{AM/Editor|WazingTime||Statewide|}}
{{AM/Bottom}}
==== AM/Badge ====
The {{tl|AM/Badge}} templates are added to the {{tl|AM/Editor}} template lines. A senior editor can also display one of the following [[Your_Rank_and_Points#Forum_badges|forum badges]] in the comments section (up to three) with the first badge providing the color background for the editor's entry. The named parameters ({{para|badge1}} {{para|badge2}} {{para|badge3}} {{para|badge4}} {{para|badge5}}) should follow the unnamed parameters (e.g. user name, rank, area managed, comment). Make the first badge that of the desired color for the user's background color.
:{{AM/Badge|GC}} GC or Global Champ
:{{AM/Badge|LC}} LC or Local Champ
:{{AM/Badge|RC}} RC or Regional Coordinator
:{{AM/Badge|CM}} CM or Country Manager
:{{AM/Badge|SM}} SM or State Manager
:{{AM/Badge|MGC}} MGC or Mentor Global Champ
:{{AM/Badge|MLC}} MLC or Mentor Local Champ
:{{AM/Badge|M}} M or Mentor
:{{AM/Badge|LAM}} LAM or Large Area Manager
:{{AM/Badge|MSM}} MSM or Multi State Manager
:{{AM/Badge|AM}} AM or Area Manager
:{{AM/Badge|MR}} ''MR or Map Raider - Note: this badge is not to be used in the AM tables, it is added to this template to support off-label use of this template suite for MapRaid! team list tables''
Example:
<small>{{Pre2|<nowiki>
{{AM/Editor|WazingTime|6|Statewide|Mostly Northern California|badge1=gc}}
{{AM/Editor|Wazzzzzz|6|Statewide|Mostly Southern California|badge1=mgc|badge2=gc}}
{{AM/Editor|BigCheeze|5|Statewide|Mostly Central California|badge1=rc|badge2=mlc|badge3=lc}}
{{AM/Editor|CountryGuru|5|Country Manager|East coast|badge1=cm}}
{{AM/Editor|StateMan|5|State Manager|Southern California|badge1=sm}}
{{AM/Editor|LargeArea|4|Large Area Manager|Southern California|badge1=lam}}
</nowiki>
}}</small>
Produces:
{{AM/TopExample}}
{{AM/Editor|WazingTime|6|Statewide|Mostly Northern California|badge1=gc}}
{{AM/Editor|Wazzzzzz|6|Statewide|Mostly Southern California|badge1=mgc|badge2=gc}}
{{AM/Editor|BigCheeze|5|Statewide|Mostly Central California|badge1=rc|badge2=mlc|badge3=lc}}
{{AM/Editor|CountryGuru|5|Country Manager|East coast|badge1=cm}}
{{AM/Editor|StateMan|5|State Manager|Southern California|badge1=sm}}
{{AM/Editor|LargeArea|4|Large Area Manager|Southern California|badge1=lam}}
{{AM/Bottom}}


== Usage ==
== Usage ==
Line 20: Line 117:
{{Pre2|<nowiki>
{{Pre2|<nowiki>
{{AM/Top}}
{{AM/Top}}
{{AM/6}}
{{AM/Country}}
{{AM/Editor|kentsmith9|Northern California|Bay Area resident}}
{{AM/Editor|kentsmith9|6|California|Bay Area resident|badge1=gc}}
 
{{AM/5}}
{{AM/Editor|FastWazer|Bay Area|Live in Bay Area}}


{{AM/4}}
{{AM/State}}
{{AM/Editor|OtherWazer1|Fremont|}}
{{AM/Editor|FastWazer|5|Bay Area|Live in Bay Area}}


{{AM/3}}
{{AM/Area}}
{{AM/Editor|NewWazer|San Jose|Some travel to Hawaii}}
{{AM/Editor|OtherWazer1|4|Fremont|}}
{{AM/Editor|AnotherWazer|San Francisco|Also Eureka}}
{{AM/Editor|NewWazer|3|San Jose|Some travel to Hawaii}}
{{AM/Editor|AnotherWazer|3|San Francisco|Also Eureka}}
{{AM/Bottom}}</nowiki>
{{AM/Bottom}}</nowiki>
}}
}}
Line 37: Line 132:


== Parameters ==
== Parameters ==
The {{tlc|AM/6}} and {{tlc|AM/5}} templates will automatically detect the page name and use that as the state to decide what region should be displayed. If the Area Manager template suite is used on a page with a name not covered in {{tl|StateForum}}, a parameter can be sent with the State name (spelled out or abbreviated).
The {{tlx|AM/Country}} and {{tlx|AM/State}} templates will automatically detect the page name and use that as the state to decide what region should be displayed. If the Area Manager template suite is used on a page with a name not covered in {{tl|RC/Data}}, a parameter can be sent with the State name (spelled out or abbreviated) as in {{tlx|AM/State|California}}.


The {{tlc|AM/Editor}} has three parameters in the following order:
* Editor name
* Area Managed
* Comments


== Example table ==
== Example table ==
{{AM/Top}}
{{AM/Top|MA}}<!-- MA added because state name is not in example pagename-->
{{AM/6|MA}}<!--  
{{AM/Country|MA}}<!-- MA added because state name is not in example pagename
-- Insert Rank 6 editors alphabetically below this line -->
-- Insert Country Manager editors alphabetically below this line -->
{{AM/Editor|Andypoms|Statewide<br/>Mostly Western MA|Connecticut based USA Country Manager, covers Massachusetts as well}}
{{AM/Editor|Rank6Example|6|Statewide|Resident of state|badge1=rc|badge2=gc|badge3=mgc}}
{{AM/5|MA}}<!--  
{{AM/Editor|Rank6Too|6|Statewide|Longtime resident of state|badge1=gc}}
-- Insert Rank 5 editors alphabetically below this line -->
{{AM/State|MA}}<!-- MA added because state name is not in example pagename
{{AM/Editor|UserX}}
-- Insert State Manager editors alphabetically below this line -->
{{AM/4}}<!--
{{AM/Editor|Rank5Example|5|Statewide|Resident of state|badge1=lc|badge2=mlc}}
-- Insert Rank 4 editors alphabetically below this line -->
{{AM/Editor|Rank5Too|5|Statewide|Working in state now|badge1=mlc|badge2=lc}}
{{AM/Editor|Scott_h|New Bedford AM, Boston to Worcester editor|MetroWest based}}
{{AM/Editor|CountryGuru|5|Vacation here|Country Manager|East cost|badge1=cm}}
{{AM/3}}<!--  
{{AM/Area}}<!--  
-- Insert Rank 3 editors alphabetically below this line -->
-- Insert Area Manager editors alphabetically below this line -->
{{AM/Editor|Djsmith89|Norwood Area|Local to the area, grew up here}}
{{AM/Editor|OtherWazer1|4|Named County|I also cover CityName|badge1=m}}
{{AM/Editor|jasonm128|Cambridge to Woburn and surrounding cities|20+ years in Boston area. Also edit in Denver and northern NJ}}
{{AM/Editor|WazerHolic|4|Another County|I don't got to show no stinking badges!}}
{{AM/Editor|Panther37|Barnstable, Dukes and Nantucket Counties (Cape Cod and Islands)|Colorado Springs based. Grew up on Cape Cod. Manages Colorado Springs area also}}
{{AM/Editor|AnotherWazer|3|San Francisco|Also Eureka}}
{{AM/Editor|NewWazer|3|San Jose|Some travel to Hawaii}}
{{AM/Editor}}
<!-- Do not add editors below this line -->
<!-- Do not add editors below this line -->
{{AM/Bottom}}
{{AM/Bottom}}
Line 66: Line 159:
<includeonly>
<includeonly>
<!-- ADD CATEGORIES BELOW THIS LINE -->
<!-- ADD CATEGORIES BELOW THIS LINE -->
[[Category:Templates]]
[[Category:Templates for or part of the state template]]
[[Category:Area Manager template]]
<!-- ADD INTERWIKIS BELOW THIS LINE -->
<!-- ADD INTERWIKIS BELOW THIS LINE -->


</includeonly>
</includeonly>

Latest revision as of 00:24, 16 August 2022

This is a documentation subpage for Template:AM.
It contains usage information, categories and other content that is not part of the original template page.

This template is a suite of subpage templates that build an Area Manager table.

Subpages

The following subpages are used to build an Area Manager table.

  • {{AM/Top}} - Top of the template: controls column headings/widths and top colors; also automatically includes the Regional Coordinators.
  • {{AM/Country}} - Country Managers heading with optional State Name as first parameter
  • {{AM/State}} - Statewide Area Managers heading with optional State Name as first parameter
  • {{AM/Area}} - Area Managers heading
  • {{AM/AreaLink}} - Area Managers heading w/link to edit {{{{RootPage}}/AM/Editor/Area}}
  • {{AM/Area2Link}} - Other Area manager table heading w/link to edit {{{{RootPage}}/AM/Editor/Area2}}
  • {{AM/Bottom}} - Bottom the the template
  • {{AM/Colspan}} - Variable used to span columns for headers
  • {{AM/Editor}} - Area/Country Manager template
  • {{AM/Badge}} - Badges for Area Manager table with color coding; details below

The automatic pagename elements in the table uses {{RootPage2}} to ensure the correct pagename is determined, so the template must be built on a page that has a valid state or territory (or USA) as the base pagename.

Valid examples:

  • USA/CommonState
  • Arizona
  • Arizona/Test
  • Puerto Rico

AM/Top

When using the AM table to also display Google Hangouts avatars, and display names, you can modify the header row accordingly. The {{AM/Top}} accepts two optional named parameters, which modify it to support GHO avatars and names.

  • |gho=yes = Will add a new line under "Username" with a Google Hangouts lookalike icon, and the default text "GHO Display Name".
  • |ghoName=DISPLAY TEXT = Can be used to change the default text shown next to the icon. This is only applied if |gho=yes is also used.

For example {{AM/Top|gho=yes}} will produce:

Username
"
  GHO Display Name
Area Managed Comments
GoogleMapMakerKing(6) [PM [Help]] 
R
  Royal GMM
Statewide
Silicon Valley, Mountainview, New York


For a custom text {{AM/Top|gho=yes|ghoName=Nickname}} will produce:

Username
"
  Nickname
Area Managed Comments


AM/Editor

The {{AM/Editor}} has four unnamed parameters in the following order:

  • Editor name
  • Editor rank
  • Area Managed
  • Comments

Any field (besides the Editor name) can be skipped, but the pipe character must be present.

There are two optional named parameters for displaying a Google Hangout avatar, and nickname.

  • |gho=GHO DISPLAY NAME - When used it will display this name in gray on a new line below the username. It can be placed after the comments or badge parameters.
  • |pic=File:Avatar USERNAME.png - When used will display the image you provide to the left of your GHO name. If not used a default Google style color tile with your initial will be shown instead.

Example:

{{AM/Editor|WazingTime||Statewide|}}

Produces:

Username Area Managed Comments
WazingTime [PM [Help]]  Statewide


AM/Badge

The {{AM/Badge}} templates are added to the {{AM/Editor}} template lines. A senior editor can also display one of the following forum badges in the comments section (up to three) with the first badge providing the color background for the editor's entry. The named parameters (|badge1= |badge2= |badge3= |badge4= |badge5=) should follow the unnamed parameters (e.g. user name, rank, area managed, comment). Make the first badge that of the desired color for the user's background color.

GC or Global Champ
LC or Local Champ
RC or Regional Coordinator
CM or Country Manager
SM or State Manager
MGC or Mentor Global Champ
MLC or Mentor Local Champ
M or Mentor
LAM or Large Area Manager
MSM or Multi State Manager
AM or Area Manager


MR or Map Raider - Note: this badge is not to be used in the AM tables, it is added to this template to support off-label use of this template suite for MapRaid! team list tables


Example:

{{AM/Editor|WazingTime|6|Statewide|Mostly Northern California|badge1=gc}}
{{AM/Editor|Wazzzzzz|6|Statewide|Mostly Southern California|badge1=mgc|badge2=gc}}
{{AM/Editor|BigCheeze|5|Statewide|Mostly Central California|badge1=rc|badge2=mlc|badge3=lc}}
{{AM/Editor|CountryGuru|5|Country Manager|East coast|badge1=cm}}
{{AM/Editor|StateMan|5|State Manager|Southern California|badge1=sm}}
{{AM/Editor|LargeArea|4|Large Area Manager|Southern California|badge1=lam}}

Produces:

Username Area Managed Comments
WazingTime(6) [PM [Help]]  Statewide
Mostly Northern California
Wazzzzzz(6) [PM [Help]]  Statewide
Mostly Southern California
BigCheeze(5) [PM [Help]]  Statewide
Mostly Central California
CountryGuru(5) [PM [Help]]  Country Manager
East coast
StateMan(5) [PM [Help]]  State Manager
Southern California
LargeArea(4) [PM [Help]]  Large Area Manager
Southern California


Usage

Place the various templates in order using them like building blocks on the page.

{{AM/Top}}
{{AM/Country}}
{{AM/Editor|kentsmith9|6|California|Bay Area resident|badge1=gc}}

{{AM/State}}
{{AM/Editor|FastWazer|5|Bay Area|Live in Bay Area}}

{{AM/Area}}
{{AM/Editor|OtherWazer1|4|Fremont|}}
{{AM/Editor|NewWazer|3|San Jose|Some travel to Hawaii}}
{{AM/Editor|AnotherWazer|3|San Francisco|Also Eureka}}
{{AM/Bottom}}

(Note: The extra line breaks will appear in the table as blank extra whitespace rows in the row above the blank line. They are here for simplifying the table visually.)

Parameters

The {{AM/Country}} and {{AM/State}} templates will automatically detect the page name and use that as the state to decide what region should be displayed. If the Area Manager template suite is used on a page with a name not covered in {{RC/Data}}, a parameter can be sent with the State name (spelled out or abbreviated) as in {{AM/State|California}}.


Example table

MA — Area, State, Country Managers, and Regional Coordinators
Regional Coordinator(s):
[RC] orbitc (PM [Help])  
[ARC1] Banished (PM [Help])  
[ARC2] SanzClew (PM [Help])  
Username Area Managed Comments
Country Managers (New England region)
(Click here to create initial Country and State sections of table)
Rank6Example(6) [PM [Help]]  Statewide
Resident of state
Rank6Too(6) [PM [Help]]  Statewide
Longtime resident of state
State Managers (New England region)
Rank5Example(5) [PM [Help]]  Statewide
Resident of state
Rank5Too(5) [PM [Help]]  Statewide
Working in state now
CountryGuru(5) [PM [Help]]  Vacation here
Country Manager
Area Managers
OtherWazer1(4) [PM [Help]]  Named County
I also cover CityName
WazerHolic(4) [PM [Help]]  Another County I don't got to show no stinking badges!
AnotherWazer(3) [PM [Help]]  San Francisco Also Eureka
NewWazer(3) [PM [Help]]  San Jose Some travel to Hawaii
UserName [PM [Help]]