View source for Template:EffectsbyIngredientDPL/doc | Elder Scrolls

==Usage==
This template makes use of the [[mw:Extension:DynamicPageList (third-party)|DynamicPageList]] extension ([http://followthescore.org/dpldemo/DPL:Manual full manual]). It serves to provide simpler access to the use of a particular DPL tag, which can be viewed in the template's source code. By looking at the page infobox in the specified category, it generates a table with four parameters: each effect of the ingredient and a list of ingredients that have the specified effect.

The template uses first <code>dpl</code> call to define the <code>vars</code> for the table, which are the four alchemical effects. Then, just as in the {{tl|SkyrimIngredients}} template, the links in the table's headers are generated using the {{tl|exists}} template. The ingredients' lists are generated by a second <code>dpl</code> call, which is stored in the {{tl|EffectsbyIngredientDPL/Cells}} sub-template to prevent a template loop.

<pre>
{{EffectsbyIngredientDPL}}
</pre>

===Lists===
<pre>{{EffectsbyIngredientDPL/Cells|{{#if:{{#var:effect1}}|{{exists|{{#var:effect1}} (Skyrim)|then={{#var:effect1}} (Skyrim)|else={{#var:effect1}}}}}}|effect1={{#var:effect1}}|effect2={{#var:effect2}}|effect3={{#var:effect3}}|effect4={{#var:effect4}}|title={{{title|{{#replace:{{PAGENAME}}|&#39;|'}}}}}}}</pre>
*The first variable is for the sub-template to only include the ingredients in the list that is linked from the specified effect.
*effect1 – first specified effect.
*effect2 – second specified effect.
*eefect3 – third specified effect.
*eefect4 – fourth specified effect.
*title – article's name generated by the <nowiki>{{PAGENAME}}</nowiki> magic word and any single apostrophe HTML symbols replaced by the actual symbol.

====EffectsbyIngredientDPL/Cells====
The second <code>dpl</code> call is used to generate a list of ingredients that has the specified effect. Then it includes the "Appearances" section and all four effect parameters from the infobox.
<pre>²{#dplreplace:²{#dplreplace:²{#dplreplace:²{#dplreplace:,¦((?s).*?)(V:\sDragonborn)((?s).*)¦²{DR}²}²¦((?s).*?)(V:\sSkyrim)((?s).*)¦}²¦((?s).*?)(V:\sHearthfire)((?s).*)¦²{HF}²}²¦((?s).*?)(V:\sDawnguard)((?s).*)¦²{DG}²}² </pre>
*The "Appearances" section is replaced with the {{tl|DG}}, {{tl|DR}}, or {{tl|HF}} templates depending on the [[Wikipedia:Regular expressions|regular expression]] matches.
<pre>²{#dplreplace:²{#dplreplace:²{#dplreplace:²{#dplreplace:²{#dplreplace:²{#dplreplace:²{#dplreplace:1,1,11,11,11,11,11,11,11,11,11,11,11,11,11,11,11,11,11,11,11,11,11,11,1¦(1{{{effect1}}}1)¦†}²¦(1{{{effect2}}}1)¦†}²¦(1{{{effect3}}}1)¦†}²¦(1{{{effect4}}}1)¦†}²¦([^†])¦}²¦(†)(?!\1+)¦}²¦(†)+¦$1}²,</pre>
*The four effect parameters from the infobox are searched to determine the specified effects and replaced with the <code>†</code> symbol. Then every other effect is removed. After that, a single <code>†</code> symbol is removed too. Lastly, any duplicate <code>†</code> symbol is replaced with a single one. Everything is done with regular expression matches.

===Example===
<nowiki>{{EffectsbyIngredientDPL}}</nowiki> code on the [[Mora Tapinella]] article.
{{EffectsbyIngredientDPL|title=Mora Tapinella}}

This code will generate a table based on the "Mora Tapinella" article's four effects. The article must be in one of the following categories: [[:Category:Skyrim: Ingredients]], [[:Category:Dawnguard: Ingredients]], or [[:Category:Dragonborn: Ingredients]].<noinclude>[[Category:Template Documentation]]</noinclude>