View source for Template:Page views double/doc

{{Documentation subpage}}
<!-- Add categories where indicated at the bottom of this page and interwikis at Wikidata -->
<!-- NOT YET HIGH USE: {{High-use}}  -->

This template displays two page view graphs and is designed for articles with spiky page views; that is, articles that are mostly stable but may trend or go viral for short periods due to media attention or innate periodicity of the topic.  The template reports daily page views in two stacked graphs (default: the last six months in log scale on the top, and the last 30 days in linear scale below), placing them in a suitable frame with individual headings. It is typically placed on an article's talk page below [[WP:TPL|other talk page banners]].  Non-trending pages with stable viewership over time do not need to use this template; try the simpler {{tl|Annual readership}} template instead.  

==Usage==
Basic syntax:
:{{tlx|Page views double}}{{snd}} one six-month log-scale graph on top, one 30-day linear-scale under it
:{{tlx|Page views double|days1{{=}}365|days2{{=}}60}}{{snd}}change to one year on top, two months on bottom
:{{tlx|Page views double|365|60}}{{snd}}same as above, using positional params {{para|1}} and {{para|2}}

Template syntax with optional parameters:
:{{tlxi|Page views double |2=expanded=|3=target= |4=title= |5=days1= |6=days2= |7=color1= |8=color2= |9=scale1= |10=scale2= |11=width= |12=height= }}

==Optional parameters==
'''Overall parameters:'''
*{{para|expanded}} can be used to override the default auto-collapsing of the message box. To prevent the graph from being collapsed on page load, use {{para|expanded|true}}.
*{{para|target}} (default: [[Help:Magic_words#Variables|<nowiki>{{SUBJECTPAGENAME}}</nowiki>]]) can be used to simultaneously specify the page in the graph title (if {{para|title}} is not specified) and the page for which page traffic is displayed.
*{{para|title}} (default: see notes) can be used to specify the page in the graph title.
*{{para|width}} (default: 570) may be used to change the width in pixels of the image.
*: '''Note''': Default of 570px is used to match standard Talk page boxed items; values outside the range of 400&ndash;980 may be problematic.
*{{para|height}} (default: 200) may be used to change the height.

'''Top graph:'''
*{{para|days1}} (default: 182) can be used to change the number of pageview days depicted in the graph. Alias: {{para|1}}.
*{{para|color1}} (default: #f30) can be used to change the graph color; accepted inputs include [[HTML color names]] (e.g., red, slategray, cornsilk) and hex codes (e.g., #0080ff, #fc0).
*{{para|scale1}} (default: log) can be used to change the scale of the y axis; accepted inputs: linear, log, pow, sqrt, quantile, quantize, and threshold.

'''Bottom graph:'''
*{{para|days2}} (default: 30) pageview days in bottom graph. Alias: {{para|2}}.
*{{para|color2}} (default: #0c6) graph color for bottom graph.
*{{para|scale2}} (default: linear) can be used to change the scale of the y axis; accepted inputs: linear, log, pow, sqrt, quantile, quantize, and threshold.

==Notes about the graph title==
If '''neither''' {{para|title}} or {{para|target}} '''are specified''', the graph title varies depending on the namespace of the page where this template is used.
*Title if placed on an article talk page:
*:'''Daily {{plainlink|url=https://tools.wmflabs.org/pageviews/?project=en.wikipedia.org&platform=all-access&agent=user&range=latest-{{{1|{{{days1|182}}}}}}&pages={{urlencode:{{{target|{{SUBJECTPAGENAME}}}}}}}|name=pageviews}} of this article'''
*Title if placed on a page in any other talk namespace (e.g., "User talk:", "Template talk:", "Wikipedia talk:", etc.):
*:'''Daily {{plainlink|url=https://tools.wmflabs.org/pageviews/?project=en.wikipedia.org&platform=all-access&agent=user&range=latest-{{{1|{{{days1|182}}}}}}&pages={{urlencode:{{{target|{{SUBJECTPAGENAME}}}}}}}|name=pageviews}} of [[Help:Magic_words#Variables|<nowiki>{{SUBJECTPAGENAME}}</nowiki>]]'''
*Title if placed on any subject page (i.e., pages in namespaces like "User:", "Template:", "Wikipedia:", etc.):
*:'''Daily {{plainlink|url=https://tools.wmflabs.org/pageviews/?project=en.wikipedia.org&platform=all-access&agent=user&range=latest-{{{1|{{{days|182}}}}}}&pages={{urlencode:{{{target|{{SUBJECTPAGENAME}}}}}}}|name=pageviews}} of this page'''

If {{para|title}} '''is not specified''', but {{para|target}} '''is specified''', the graph title is set as "Daily pageviews of ''target page''", with the target page linked.
*For example, inputting {{para|target|XYZ}} would set the graph title as:
*:'''Daily {{plainlink|url=https://tools.wmflabs.org/pageviews/?project=en.wikipedia.org&platform=all-access&agent=user&range=latest-{{{1|{{{days1|365}}}}}}&pages={{urlencode:{{{target|{{SUBJECTPAGENAME}}}}}}}|name=pageviews}} of [[XYZ]]'''

If {{para|title}} '''is specified''', regardless of the specification of {{para|target}}, the graph title is set as "Daily pageviews of ''text''", with the text unlinked.
*For example, inputting {{para|title|XYZ}} would set the graph title as:
*:'''Daily {{plainlink|url=https://tools.wmflabs.org/pageviews/?project=en.wikipedia.org&platform=all-access&agent=user&range=latest-{{{1|{{{days1|182}}}}}}&pages={{urlencode:{{{target|{{SUBJECTPAGENAME}}}}}}}|name=pageviews}} of XYZ''' 
*For example, inputting {{para|title|<nowiki>[[XYZ]]</nowiki>}} would set the graph title as:
*:'''Daily {{plainlink|url=https://tools.wmflabs.org/pageviews/?project=en.wikipedia.org&platform=all-access&agent=user&range=latest-{{{1|{{{days1|182}}}}}}&pages={{urlencode:{{{target|{{SUBJECTPAGENAME}}}}}}}|name=pageviews}} of [[XYZ]]'''

==Examples==

{| class="wikitable unsortable" style="width:100%"
|
;Template defaults (collapsed)
<code><nowiki>{{Page views double}}</nowiki></code> produces:
{{Page views double}}
|-
|
;Template with a specified target page, shorter period in the top graph, and cobalt blue coloring in the bottom graph (collapsed)
<code><nowiki>{{Page views double|days1=150|target=Pancake|scale=log|color2=cobalt}}</nowiki></code> produces:
{{Page views double|days1=150|target=Pancake|color2=cobalt}}
For comparison, here's the same template as above except with both graphs in linear scale:
{{Page views double|days1=150|target=Pancake|color2=cobalt|scale1=linear}}
----
|-
|
;Template with a target page with very spiky results, two-year period in the top log scale graph,  (collapsed)
<code><nowiki>{{Page views double|target=Diwali|days1=730|days2=45}}</nowiki></code> produces:
{{Page views double|target=Diwali|days1=730|days2=45}}
|-
|
;Template with a specified target page, linear scale and same color in both graphs (uncollapsed)
<code><nowiki>{{Page views double|target=Rubber duck|color1=maroon|scale1=linear|color2=maroon}}</nowiki></code> produces:
{{Page views double|target=Rubber duck|color1=maroon|scale1=linear|color2=maroon}}

|-
|
; Flip the graphs so the reddish, six-month interval log scale graph is on the bottom (collapsed)
<code><nowiki>{{Page views double|target=Rubber duck|days1=30|days2=182|color1=#0c6|color2=#f30|scale1=linear|scale2=log}}</nowiki></code>
{{Page views double|target=Rubber duck|days1=30|days2=182|color1=#0c6|color2=#f30|scale1=linear|scale2=log}}
|-
|}

==Template parameters==
{{TemplateData header}} 
<templatedata>
{
	"params": {
		"target": {
			"label": "Target",
			"description": "May be used to specify the page for which page traffic is displayed, and the title (if empty).",
			"type": "wiki-page-name",
			"default": "Name of the current article page",
			"example": "Main Page"
		},
		"title": {
			"label": "Title",
			"description": "May be used to specify the page name in the graph title (for default, see doc)",
			"type": "string",
			"default": "(varies per namespace, if none specified; see doc)"
		},
		"1": {
			"type": "number",
			"default": "182",
			"label": "Number of days back",
			"description": "Number of days back to show in the top chart"
		},
		"2": {
			"type": "number",
			"default": "30",
			"label": "Number of days back to show in bottom chart",
			"description": "Number of days back to show in bottom chart"
		},
		"color1": {
			"label": "Graph color for top chart",
			"default": "#f30",
			"example": "#f00",
			"type": "string",
			"description": "Shade with which to highlight the data in the top chart"
		},
		"color2": {
			"label": "Graph color for bottom chart",
			"default": "#0c6",
			"example": "#f00",
			"type": "string",
			"description": "Shade with which to highlight the data in the bottomchart"
		},
		"scale1": {
			"label": "Graph scale for top chart",
			"description": "Scaling could be one of these: linear, log, pow, sqrt, quantile, quantize, and threshold",
			"default": "log",
			"example": "linear",
			"type": "string"
		},
		"scale2": {
			"label": "Graph scale for bottom chart",
			"description": "Scaling could be one of these: linear, log, pow, sqrt, quantile, quantize, and threshold",
			"default": "linear",
			"example": "log",
			"type": "string"
		},
		"expanded": {
			"label": "Expanded",
			"description": "Set to true to override the default collapsed state",
			"type": "boolean",
			"default": "false"
		},
		"width": {
			"label": "Width",
			"description": "Width for the chart in pixels, if different from the default.",
			"type": "number",
			"default": "470"
		},
		"height": {
			"label": "Height",
			"description": "Height for the chart in pixels, if different from the default.",
			"type": "number",
			"default": "200"
		}
	},
	"format": "block",
	"description": "This template inserts two vertically stacked graphs of daily pageview statistics (Y axis) over the past N days (X axis) for a page."
}
</templatedata>
<!--
	"paramOrder": [
		"1",
		"2",
		"target",
		"title",
		"days1",
		"days2",
		"color1",
		"color2",
		"scale1",
		"scale2",
		"width",
		"height"
	],
-->

==Redirects==
*{{tl|Annual Readership double}}
*{{tl|Pageviews double}}

==See also==
* {{tlg|Annual readership}}
* {{tlg|Graph:PageViews}} – Use instead, if further variations are desired

<includeonly>{{sandbox other||
<!-- Categories below this line; interwikis at Wikidata -->
[[Category:Wikipedia pageviews]]
[[Category:Chart, diagram and graph formatting and function templates]]
}}</includeonly>