View source for Template:Infobox magazine/doc

{{Documentation subpage}}
<!--Categories where indicated at the bottom of this page, please; interwikis at Wikidata (see [[Wikipedia:Wikidata]])-->
{{Auto italic title}}
{{Lua|Module:Infobox|Module:InfoboxImage|Module:Check for unknown parameters}}

== Usage ==
{{Parameter names example | _template= | italic title | title | logo | logo_size | image_size | image_file | image_alt | image_page | caption | image_caption | editor_title | editor | editor_title2 | editor2 | editor_title3 | editor3 | editor_title4 | editor4 | editor_title5 | editor5 | editor_title6 | editor6 | previous_editor | staff_writer | photographer | category | frequency | format | circulation | publisher | paid_circulation | unpaid_circulation | circulation_year | total_circulation | creator | founder | founded | firstdate | finalnumber | finaldate | lastdate | company | country | based | language | website | issn | ISSN | eissn | eISSN | oclc | OCLC }}

To use this template please add the following code to the top of the article.

''Note: If you have no information for a certain parameter please just blank it rather than removing it so that other editors can see that it needs adding at a later stage''

<pre style="overflow:auto">
{{Infobox magazine
| title           = 
| logo            = 
| logo_size       = <!-- default is 180px -->
| image_file      = <!-- cover.jpg (omit the "file:" prefix) -->
| image_size      = <!-- default is 180px -->
| image_alt       = 
| image_caption   = 
| editor          = <!-- up to |editor5= -->
| editor_title    = <!-- up to |editor_title5= -->
| previous_editor = 
| staff_writer    = 
| photographer    = 
| category        = 
| frequency       = 
| format          = 
| circulation     = 
| publisher       = 
| paid_circulation   = 
| unpaid_circulation = 
| circulation_year   = 
| total_circulation  = 
| founder         = 
| founded         = 
| firstdate       = <!-- {{Start date and age|YYYY|MM|DD}} -->
| finaldate       = <!-- {{End date|YYYY|MM|DD}} -->
| finalnumber     = 
| company         = 
| country         = 
| based           = 
| language        = 
| website         = <!-- {{URL|example.com}} -->
| issn            = 
| oclc            = 
}}
</pre>

If the magazine is defunct, include the '''finaldate''' and '''finalnumber''' parameters. If the magazine is still publishing, then these parameters should be omitted entirely:

<pre>
| finaldate       = 
| finalnumber     = 
</pre>

If a breakdown into paid, unpaid and total circulation figures is desired, use the following lines instead of the '''circulation''' parameter:

<pre>
| paid_circulation   = 
| unpaid_circulation = 
| circulation_year   = 
| total_circulation  = 
</pre>

The '''company''' parameter should list the publishing company. The '''publisher''' parameter should be the named person who publishes the magazine.

The '''previous_editor''' parameter should include earlier, notable, editors. In particular, the ''founding'' editor (if different from current editor), to a reasonable maximum number.

If '''image_file''' is a .djvu and a particular page is desired, then use the '''image_page''' parameter: 

<pre>
| image_page =
</pre>

If other editing positions are required (e.g. Senior Editor or Associate Editor), use the additional editor fields show below.
<pre>
| editor2         = 
| editor_title2   = 
| editor3         = 
| editor_title3   = 
| editor4         = 
| editor_title4   = 
| editor5         = 
| editor_title5   = 
</pre>

=== Parameter explanations and examples ===
A list of each field, what it is for and an example entry. Required parameters are asterisked (*).

{| class="wikitable"
! Parameter
! Explanation
! Example
|-
! title*
| The name of the magazine.
| style="text-align:center;" |<code>The Wikipedian</code>
|-
| '''logo'''
| A logo relevant to the magazine.
| style="text-align:center;" |<code>Logo.png</code>
|-
| '''logo_size'''
| The size of the logo.
| style="text-align:center;" | <code>200px</code><br />(Will default to 180px if no size is stated)
|-
| '''image_file'''
| An image relevant to the magazine. ''(Usually the cover)''.
| style="text-align:center;" |<code>Image.png</code>
|-
| '''image_size'''
| The size of the image.
| style="text-align:center;" | <code>200px</code><br />(Will default to 180px if no size is stated)
|-
| '''image_alt'''
| A description of the image's visual appearance, suitable for someone who cannot see the image. See [[WP:ALT]].
| style="text-align:center;" |<code>Mostly-assembled globe of puzzle pieces, each with a letter in a different script. The caption says "WikipediA: The Free Encyclopedia".</code>
|-
| '''image_page'''
| The desired page (for .djvu files).
| style="text-align:center;" |<code>7</code>
|-
| '''image_caption'''
| A description of the image.
| style="text-align:center;" |<code>''The Wikipedian'' Issue 169, cover dated 31 November 1909</code>
|-
| '''editor'''
| The name of the editor of the magazine. (Must be used in conjunction with '''editor_title''' field)
| style="text-align:center;" |<code><nowiki>[[John Smith]]</nowiki></code>
|-
| '''editor_title'''
| The editor's job title. Editor, Editor-in-Chief etc.
| style="text-align:center;" |<code>Editor</code>
|-
| '''editor2'''
| The name of second editor.
|
|-
| '''editor_title2'''
| The second editor's job title.
|
|-
| '''editor3'''
| The name of third editor.
|
|-
| '''editor_title3'''
| The third editor's job title.
|
|-
| '''previous_editor'''
| Notable preceding Editors. ''(See Long Lists section below)''
| style="text-align:center;" |<code><nowiki>[[Jim Smith]]</nowiki></code>
|-
| '''staff_writer'''
| Staff Writer(s). (Please break multiple lines with <nowiki><br /></nowiki>)<br />''(See Long Lists section below)''
| style="text-align:center;" |<code><nowiki>[[Alan Smithee]]<br />[[Jane Smithee]]</nowiki></code>
|-
| '''photographer'''
| Photographer(s). (Please break multiple lines with <nowiki><br /></nowiki>)<br />''(See Long Lists section below)''
| style="text-align:center;" |<code><nowiki>[[Annie Smithee]]<br />[[Judy Smithee]]</nowiki></code>
|-
! category*
| The subject group of the magazine, e.g., Sport, Nature, History. Use as many as necessary.
| style="text-align:center;" |<code><nowiki>[[Science]], [[Sport]], [[History]]</nowiki></code>
|-
! frequency*
| Monthly, weekly, daily, etc.
| style="text-align:center;" |<code>Monthly</code>
|-
! format*
| paper size
| style="text-align:center;" |<code>A4</code>
|-
| '''circulation'''
| Circulation figures.<br />''(If circulation breakdown required/available, leave this field blank and see fields lower down this table)''.
| style="text-align:center;" |<code>50,000</code>
|-
| '''publisher'''
| The '''person''' that publishes the magazine.
(''Do not put companies in this field. Use the company field below.'')
| style="text-align:center;" |<code><nowiki>[[John Smith]]</nowiki></code>
|-
| '''founder'''
| The '''person''' that founded the magazine.
(''Do not put companies in this field. Use the company field below.'')
| style="text-align:center;" |<code><nowiki>[[John Smith]]</nowiki></code>
|-
| '''founded'''
| The date the magazine company was founded.
| style="text-align:center;" |<code><nowiki>{{start date|1998|3|13|df=y}}</nowiki></code>
|-
! firstdate*
| The date of publication of the first issue of the magazine.
| style="text-align:center;" |<code><nowiki>{{start date|1998|3|13|df=y}}</nowiki></code>
|-
| '''company'''
| The '''company''' that publishes the magazine.
| style="text-align:center;" |<code><nowiki>[[The magazine publishing company]]</nowiki></code>
|-
! country*
| Country of origin. e.g. United Kingdom
| style="text-align:center;" |<code>United Kingdom</code>
|-
| '''based'''
| The town/city that the magazine is based in.
| style="text-align:center;" |<code><nowiki>[[Wiki Town]], [[Wikiville]]</nowiki></code>
|-
| '''language'''
| The language the magazine is printed in.
| style="text-align:center;" |<code><nowiki>English</nowiki></code> or, for language names unlikely to be familiar to readers,  <code><nowiki>[[Xyzish language|Xyzish]]</nowiki></code>
|-
| '''website'''
| The official website of the magazine.
| style="text-align:center;" |<code><nowiki>{{URL|example.com}}</nowiki></code>
|-
! issn
| The [[International Standard Serial Number]] of the magazine.  If the magazine has both a print and electronic version with separate ISSNs, use <code>issn</code> and <code>eissn</code>.
|
|-
! oclc
|  the [[Online Computer Library Center|OCLC]] number of the magazine (automatically linked to http://WorldCat.org)
|
|-
| '''finaldate'''
| The date of the final issue of the magazine.<br />''(Only use if the magazine has ceased publication)''
| style="text-align:center;" |<code>31 April 1999</code>
|-
| '''finalnumber'''
| The edition number of the final issue.<br />''(Only use if the magazine has ceased publication)''
| style="text-align:center;" |<code>Vol 77 No 88</code>
|-
! colspan="3" style="background-color: #ccf;" | Circulation breakdown parameters
|-
| '''paid_circulation'''
| The circulation of "paid for" copies of the magazine.
|
|-
| '''unpaid_circulation'''
| The circulation of free copies of the magazine.
|
|-
| '''total_circulation'''
| The total circulation of the magazine.
|
|-
| '''circulation_year'''
| The year for which the '''total_circulation''' figure is provided
|
|}

=== Long lists ===
Where long lists of names are required and may cause excessive lengthening of the Infobox, please use the {{tl|hidden}} template. An example usage is shown below.

{| class="wikitable"
|-
|<!--column1--><code><nowiki>

| staff_writer = {{hidden|ta1=left|Staff writers| Tim Edwards<br />Graham Smith<br />Tony
Ellis<br />Craig Pearson<br />Tom Francis<br />Richard
Cobbett<br />Jim Rossignol<br />John Walker<br />Alec
Meer<br />Matt Avery<br />Chris Buxton<br />Michael
Gapper<br />[[Kieron Gillen]]<br />Mike Channell<br />Tim
Stone<br />Adam Oxford<br />Quintin Smith<br />[[Duncan
Harris]]<br />Drew Northcott<br />David Lyttleton }}</nowiki></code>
|-
|}<!--end wikitable-->

=== Circulation data ===
Periodical circulation data is collected by independent auditing organizations.  Basic circulation totals are often available free of charge via the web:
; [[Alliance for Audited Media]]: [https://abcas3.auditedmedia.com/ecirc/index.html Total Circ]
; [[BPA Worldwide]]: [http://www.bpaww.com/bpaww#?targeturl=/bpaww/Content/MainContent/Resources/DataTables.htm&target=2&languageid=1&homepage=/BPAWW/Content/MainContent/Home/index.html&footerpage=/BPAWW/content/maincontent/footer/english.htm Media Stats]
; [[Audit Bureau of Circulations (UK)]]: [https://www.abc.org.uk/verification/print-digital-events Print, Digital and Event Figures]

== Microformat ==
{{UF-hprod}}

== Tracking category ==
* {{clc|Pages using infobox magazine with unsupported parameters}}

== See also ==
* {{tl|Infobox journal}}

{{Organization infoboxes}}

<includeonly>
{{basepage subpage|
<!--Categories below here, please; interwikis to Wikidata.-->
[[Category:Magazine templates]]
[[Category:Organization infobox templates|Magazine]]
[[Category:Publishing infobox templates|Magazine]]
[[Category:Templates that add a tracking category]]
[[Category:WikiProject Journalism templates]]
[[Category:WikiProject Magazine templates]]
}}</includeonly>
<templatedata>
{
	"params": {
		"italic title": {},
		"title": {},
		"logo": {},
		"logo_size": {},
		"image_size": {},
		"image_file": {},
		"image_alt": {},
		"image_page": {},
		"caption": {},
		"image_caption": {},
		"editor_title": {},
		"editor": {},
		"editor_title2": {},
		"editor2": {},
		"editor_title3": {},
		"editor3": {},
		"editor_title4": {},
		"editor4": {},
		"editor_title5": {},
		"editor5": {},
		"previous_editor": {},
		"staff_writer": {},
		"photographer": {},
		"category": {},
		"frequency": {},
		"format": {},
		"circulation": {},
		"publisher": {},
		"paid_circulation": {},
		"unpaid_circulation": {},
		"circulation_year": {},
		"total_circulation": {},
		"creator": {},
		"founder": {},
		"founded": {},
		"firstdate": {},
		"finalnumber": {},
		"finaldate": {},
		"lastdate": {},
		"company": {},
		"country": {},
		"based": {},
		"language": {},
		"website": {},
		"issn": {},
		"ISSN": {},
		"eissn": {},
		"eISSN": {},
		"oclc": {},
		"OCLC": {}
	},
	"format": "block"
}
</templatedata>