View source for Talk:Fan Expansions

{{Breadcrumbs|link1={{EditorManualLink}}}}

== Introduction ==
List of tasks and guides to make '''{{FanExpansionsLink}}''' section on WiCa '''great'''.

== TO-DO LIST ==
* Phase 1: create fan expansion pages for everything in the Carcassonne Central downloads area - IN PROGRESS
* Phase 2: create fan expansion pages for everything in the German Carcassonne Forum downloads area
* Phase 3: create fan expansion pages for everything in the Czech Carcassonne Forum downloads area
* Phase 4: create fan expansion pages for everything on BoardGameGeek
* Phase 5: review master fan expansion list from wolnic to see what still needs a page and make a plan

== Considerations ==
* Expansions that were released in stages should be combined into a single page.
* Remakes of expansions in a different edition of artwork are not separate expansions.
* There are other situations where it might make sense to combine expansions into a single entry.
* Fan expansions for spin-offs also deserve some love and attention, but are outside the scope of this list. They can be done in parallel with this effort.

== Suggestions ==
* The JCloisterZone team would like to have tile images for fan expansions loaded into Fancarpedia concurrently with pages being created on Wikicarpedia. Shapes can be created later.
* When fan expansions are implemented in JCloisterZone, they will typically create an expansion icon for them. It would be nice if expansion authors could add these icons as watermarks to their fan expansion, or at least give permission for someone else to add them.
* It could also be nice if we can provide tuckboxes for fan expansions? But I don't necessarily want to slow us down with too many tasks; we can add tuckboxes later too.
* [[user:Scott|Scott]] would like to promote fan expansions on the Carcassonne Central Facebook page, and is interested in 3D-ish mockups of fan expansion components to assist with that.
* Some fan expansions that do not fit thematically with regular Carcassonne may fit better with one of the spin-offs which did not exist when that fan expansion was created.

== Categorization Thoughts ==
It has long been recognized that when a list gets too long it becomes difficult to manage, and efforts are made to subdivide. There have been various attempts in the past to subdivide Carcassonne fan expansions using a variety of criteria (e.g. expansions without tiles versus expansions with tiles). I am not sure how well these distinctions are working for us.

I would like to propose a new way to think about subdividing fan expansions, which is to imagine that you are responsible for publishing an expansion into retail and you must choose one of the four box sizes to use:
# Mini-sized box (e.g. Mage &amp; Witch) 
# Half-sized expansion box (e.g. Inns & Cathedrals)
# Regular-sized game box (e.g. Wheel of Fortune)
# Big Box-sized box (e.g. Big Box 7)

I think that the size of box that an expansion's components would theoretically fit into is a good indication of the level of effort required to create those components for actual play, and will be more helpful for helping fans to find and try fan expansions. They might not be ready for printing hundreds of forest tiles, but a simple six-tile expansion like Fruit Trader is quite achievable.

== Standardized rule pages ==
Each of rules was made by different author in different time. There are widely used different approach of written rules. It is good to rewrite then to standardized C2/C3 form known by other official expansions.

=== Basic structure of Fan Expansion page ===
* '''Fan expansions disclaimer'''
* '''Fan expansion ad description''', which will be also used in SEO and Social media sharing - in <code><nowiki><section begin="description" /></nowiki></code> and <code><nowiki><section end="description" /></nowiki></code>, - it will be create extra Template for it <code><nowiki>{{ExpansionDescription|colors...|image=...}}</nowiki></code> Like on {{BardsCarcassonneLink|logo=noborder}}
* '''General info and comments''' - information about
** author,
** download section,
** ** expansion symbol (if any)
** Preview of tiles (if any)
** Print sheet of tiles (if any)
* '''Content''' - summary list of total tiles by type, new figures with pictures, tokens with example picture, etc.<br />Use [[:Template:Figure]] / [[:Template:Piece]] names and images with requested count like on {{BlackDragonLink|logo=noborder}} page.
* '''Required expanion(s)''' - list of required expansion to play (check {{BlackTowerLink|logo=noborder|anchor=Required_expansion}})
* '''New land tiles''' - list of specific new land tiles which are not usual and their configuration of features can be confused for players, like road under city from {{PrincessDragonLink|logo=noborder}}
* '''Rules''' - finaly rules for expansion, each game mechanics has separated rules in Phases, where each mechanics started with name of it. If only one mechanics, use '''Gameplay''' header. In each header place Feature / Figure / Piece image to right corner. Like on {{BlackDragonLink|logo=noborder}} page.
* '''Rules history''' - list of large changes of rules in in ascending order (from first to recent change). Like on {{CourierLink|logo=noborder}} page.
* '''Other expansions''' - list of rules for specific expansions made by [[:Template:OtherExpansionRule]] template
* '''Tile distribution''' - images of all tiles, all tokens, etc in expansion divided by discribution in order C3/C2/C1, WE3/WE2/WE1/WD. When multiple expansions on same page (like expansions The Wells, First Wells and Wells II on {{WellsLink|logo=noborder}} page), follow also edition order.
* '''Footnotes''' - event that page doesn't contains any <code><nowiki><ref></nowiki></code> section, footnotes paragraph contains link to explain rule icons used in Other Expansion interactions.

=== Basic structure of Rules section ===

* '''Preparation''' - prepare tiles, cards, where place tokens, neutral figures, how to distribute other game material between players
* '''Gameplay''' - rules divided to standard rule phases {{ColorGreen|1. Placing a tile}}, {{ColorBlue|2. Placing a meeple}} and {{ColorRed|3. Scoring a feature}}.

: '''Final scoring''' has to be part of {{ColorRed|3. Scoring a feature}} section placed at the end of section.

=== Game rules changed ===
By default, rules has to be played for Basic game. All interactions has to be added into Other Expansions section.<br />
When expansion requires other expansion to play, then this expansion has to be mentioned in '''Required expansion(s)''' section.

=== Create other WiCa stuff ===
* Create expansion symbol if not created. Please kindly ask [[User:Snearone|Snearone]] to create one.
* Create Name/Link templates - ask [[User:Bumsakalaka|Bumsakalaka]] for it

=== Updating other pages ===
Every new expansion brings some new features, new figures / special figures / neutral figures / tokens / wooden pieces and maybe also something else. Add these into:
# [[:Template:Feature]] if there is new feature
# [[:Template:Figure]] if there is new figure
# [[:Template:Piece]] if there is new token / wooden piece or other game material

It is important also to update existing expansions pages to work with this new stuff like Figure / Piece.

* [[:Template:ScoringRowMajority]] - Calculation of majority on the Feature
* {{BlackDragonLink}} - Include new figures to the list of figures he can eat, or figures on new wooden piece
* {{BlackDragonLink}} - Include new features to features where figures are protected against the Black Dragon
* {{COVID19Link}} - Include new features to features where can COVID-19 spread
* {{VistasLink}} - Include new features to table of scorable and nonscorable features

Create all interactions for new expansion to existing expansions. And include them vice-versa:
* For official expansions use approach used in {{GermanCathedralsLink|edition=C2|anchor=Fan_Expansions}}
* For fan-expansions include them under Expansion selector in standalone paragraph like in {{RobbersSonLink|anchor=Fan_Expansions}}

== Working in progress ==

* [[User:Bumsakalaka/VL]] Village Life
* [[User:Bumsakalaka/Cliffs_and_Waterfalls]] Cliffs and Waterfalls
* [[User:Bumsakalaka/NKO]] New King's Order
* [[User:Bumsakalaka/WP]] Wandering Preachers
* [[User:Bumsakalaka/ČV]] Czech Flag
* [[User:Bumsakalaka/PA]] Pope of Avignon
* [[User:Bumsakalaka/JS]] JPutt's Seasons
* [[User:Bumsakalaka/HA]] Halfling Abbeys
* [[User:Bumsakalaka/OT]] Olomoucké tvarůžky
* [[User:Bumsakalaka/MM]]  Meteorites
* [[User:Bumsakalaka/RG]] The Royal Gates
* [[User:Bumsakalaka/HP]] Hungarian Promo
* [[User:Bumsakalaka/BC]] Bumbalka Cottage
* [[User:Bumsakalaka/100pt]] Alternative scoring boards

<span id="expansion_selector"></span>

== Expansion selector ==
{{ExpansionSelector|height=200px}}

=== UX changes ===

* 1. Set position sticky for <code><nowiki><ul role="tablist"></nowiki></code> for situations when expansion selector will have fixed height
* 2. Alphabetical order of expansions (except numbered large and minis) in Minor and Other expansions, visitors didn't know order of releasing of mini expansions.

=== Preselection expansions ===
Like Automatically preselect German Cathedrals by query parameter, for example <code>?selector=showWells</code> or <code>?selector=showFamilyFeud,showGambplesLuck</code>.<br />Maybe this extension [https://www.mediawiki.org/wiki/Extension:UrlGetParameters Extension:UrlGetParameters] can help, because it allows to read query value by <code><nowiki>{{#urlget:selector}}</nowiki></code> which can be set by <code><nowiki>data-selector-always="{{#urlget:selector}}"</nowiki></code>.<br />
In {{GermanCathedralsLink|anchor=Fan_Expansions|logo=noborder}} are links to Fan expansion like {{WellsLink|logo=noborder}}. But when clicking to link, other expansion rule described interaction between German Cathedrals and The Wells are not showed, if visitor has no preselected German Cathedrals in Expansion Selector.<br />
Another issue is {{Feature|name=CoatOfArmsGrey|edition=C2|variant=imageandtext|size=x20px}} which we want to link to {{GamblersLuckLink}} but into Other Expansion Rules with selected {{FamilyFeudLink}}.

=== Dynamic Tabs ===
As there are no major and other expansions for Winter Edition, when you open [[{{Path|Winter_Scoring_During_Turn_Sequence}}|'''Winter Scoring During Turn Sequence''']] you get first tab empty with Major Expansions (0/0). This is not good, because by default filter, in WE there is none Major expansions.

My point is, if there is none valid expansions for selected filter, hide empty tabs. Which will be more clear and UX friendly, when going to mentioned '''Winter Scoring During Turn Sequence'''.

=== <del>Dynamic selectors</del> - DONE ===
<del>Regular Expansion Selector is used for official expansions and all combinations defined in [[:MediaWiki:ExpansionData.js]] covers only them.<br />
<br />
Almost every fan-expansion brings new combinations for interactions rules. To not update and enlarge official combinations, define combinations direct in code.<br />
For example: Rule requires Dragon or Black Dragon will be defined by string representing JSON: <code><nowiki>[ "OR", "showDragon", "showBlackDragon" ]</nowiki></code>.
This json will be stored in <code><nowiki>data-expansion-selector</nowiki></code> and when Expansion Selector will be initialized, it checked all elements with attribute <code>data-expansion-selector</code>, create new internal selector like <code>showDynamicSelector1</code> and replace this selector <code>data-dynamic-selector</code> to <code>className</code> on HTML element, to prevent do it twice. Check [[User:Bumsakalaka#Other_expansions|'''Example of usage''']].</del>

=== <del>Selectors for Fan expansions</del> - DONE ===
<del>Expansion selector doesn't support Fan expansions yet. So on fan expansion page are all interactions with fan expansions are always visible.</del>

<del>Ideas how to include fan expansions:</del>
* <del>On [[:Expansion_Selector_Labels]] include all supported fan expansions page like <code><nowiki><div class="fan-expansion" data-input="BlackDragon">{{BlackDragonName}}</div></nowiki></code></del>
* <del>When including expansion selector by <code><nowiki>{{ExpansionSelector|fanexpansions=true}}</nowiki></code> show Fan expansions tab and create all selectors like <code>showBlackDragon</code> by all <code>.fan-expansion</code> with value from <code>data-input</code>.</del>

<del>Issue is, that preselected expansions are shared between pages. It's important, that if user are in Game Figures and change selection in Expansion Selector, it will not delete Fan Expansions preselected on any previous page, when are Fan expansions showed in Expansion Selector.</del>

<span id="sorting_fan"></span>
=== <del>Sorting fan expansion</del> - DONE ===
<del>There will be good to sort fan expansions during including then in Expansion Selector. Each record contains new parameter <nowiki><code>data-sorting-value="{{BlackDragonName|variant=sorting}}"</code></nowiki> which include translated sorting name of expansion.</del>

=== Place Quick Selector on begin ===
Allow to show quick selector as first tab.
Possibile solution by JS: <code>$('li[aria-controls="tabs-quick"]').detach().prependTo('#_Tabs_ ul').find('a').trigger('click')</code>

=== <del>Dynamic append fan expansion selector to derived classes</del> - DONE ===
<del>Some expansions can be add to derived classes automatically without code stuff. For example {{WetlandsLink|logo=noborder}} are double sized tiles. So they should be counted in <code>showDoubleSizedTiles</code>. So adding attribute to fan expansion in [[Expansion_Selector_Labels]] like <code>data-selector-appendclasses="['showDoubleSizedTiles']"</code> will automatically add this expansion to <code>showDoubleSizedTiles</code> and also to derived classes uses <code>showDoubleSizedTiles</code>. Array is required, because fan expansion can be added to multiple different derived classes.</del>

=== Fan expansion derivates of official expansions ===
There are fan expansions which uses same game mechanics which mini official expansions. Nice example is {{LabyrinthsLink|logo=noborder}} or {{FlyingMachines2Link|logo=noborder}}. Game reference pages uses name of mini expansion to this game mechanics. So we can dynamically said that when FlyingMachines2 is in expansion selector, show all Flying Machines stuff.

# One solution can be, that each mini will create selector with '''_Mechanics''' at end. Priginal selector well be kept as it is. And new derived class name will be created automatically like <code>showLabyrinth_Mechanics = [OR,"showLabyrinth"]</code> which will be dynamically appendable by <code>data-selector-appendclasses</code>, so {{LabyrinthsLink|logo=noborder}} can be append to <code>showLabyrinth_Mechanics</code> and all stuff for Labyrinth will be showed if one or both from {{LabyrinthLink|logo=noborder}} and {{LabyrinthsLink|logo=noborder}} will be selected.
# Another solution can be, that each mini will create selector with '''Mini''' at end. Like <code>showLabyrinthMini</code> which will be selector for expansion itself. And create derived classname <code>showLabyrinth = [OR,"showLabyrinthMini"]</code> which will be dynamically appendable by <code>data-selector-appendclasses</code>, so {{LabyrinthsLink|logo=noborder}} can be append to <code>showLabyrinth</code> and all stuff for Labyrinth will be showed if one or both from {{LabyrinthLink|logo=noborder}} and {{LabyrinthsLink|logo=noborder}} will be selected.

This can be applicable for expansions which not has <code>children</code> (mini with children is {{AbbotLink|logo=noborder}} <code>inputAbbotAndGardens</code>).

== Make WikiCarpedia Great / Yes we can ==

=== Feature value for scoring a Castle ===
It is not very clear, what is the value of feature when triggering score of a {{Feature|name=Castle}}. If will be great to add row which will tell visitor that this is value for castle scoring on [[:Carcassonne_Scoring_During_the_Game|Carcassonne Scoring During the Game]].

== Checklist ==
I have some idea with some "checklist" which will contains a list of required stuff for each page. Like:
Has page {{UX?
Has page {{ChooseDesign?
Has page type expansion new figures?
3a. If yes are they in Template:Figure?
3b. If yes, is it updated Diet plan on Princess Dragon C1 ?
3c. If yes, is it updated Diet plan on Princess Dragon C2 ?
etc.
This will also require to set type of Page wich allows to work with different required stuff on pages depend on page type - like different parts are on expansions and different on designers or templates 
This part will be not translatable and will be output of translations like and looks like:
{{Checkboxes
 |type=expansion
 |choosedesign=1
}}

Which will tell that ChooseDesign was added.
In case, that UX was not made, page will be added to hidden category Category:Editor Manual - Missing UX - ux, which will tell, that when {{UX}} will be added, it's importat to add new parameter |ux=1 to Checkboxes 
So when someone will add {{UX}} to page, category will be automaticaly removed.
Bumsakalaka — Today at 8:12 PM
Benefits:
It is possible to maintain important things and made some summary, where it's not yet made.
If someone mark that some "parameter=1" it will be stored who and when - for some complains 😄
If it will be created new parameter, all pages of specific type will be marked that they are missing that stuff.
This will standardise also look of all pages with the same type