ICT:FinalConfig - PLACE - Revision history

Mngr at 11:09, 17 February 2026

2026-02-17T11:09:20Z

← Older revision		Revision as of 11:09, 17 February 2026
Line 152:		Line 152:

	! Notes		! Notes
	\| {{{field\|Notes\|input type=~~tex~~		\| {{{field\|Notes\|input type=textarea}}}

			\|}

			{{{standard input\|save}}}

			{{{end template}}}
			</pre>

			The first section avoids MediaWiki edit clutter.
			<pre>
			{{{info
			\|no summary
			\|no preview
			\|no minor edit
			\|no watch
			\|no footer
			}}}
			</pre>

			The field Label (displayed to the user as “Name”) is mandatory for all entities.
			This requirement is not implemented using the Page Forms \|mandatory option, as this produces unusable white error boxes in the dark Vector-2022 environment.

			Instead:
			- the requirement is communicated via text and (*)
			- enforcement is handled via JavaScript at save time

			= Dashboard page =
			Dashboard:Place
			<pre>
			= 🗺️ Costa Sano Research PLACE Dashboard =

			📖 [[Dashboard:Place/Help\|Need Help?]]

			{\| class="wikitable sortable"
			! Code !! Title !! Type !! Parent !! Map
			{{#cargo_query:
			tables=Places
			\|fields=_pageName,_pageTitle,Label,Type,Parent,Latitude,Longitude
			\|where=_pageNamespace=3006
			\|order by=_pageTitle
			\|format=template
			\|template=PlaceRow
			\|named args=yes
			\|cache=no
			}}
			\|}

			Choose your place code corresponding to above table and respecting the naming conventions.
			Take maximum 6 capital letters for the code.

			{{#forminput:
			form=Place
			\|namespace=Place
			\|button text=➕ New place
			\|returnto=Dashboard:Place
			}}

			<div style="text-align:right; font-size:90%;">
			Last updated: {{CURRENTDAY}} {{CURRENTMONTHNAME}} {{CURRENTYEAR}} – {{CURRENTTIME}} UTC
			</div>
			</pre>

			IMPORTANT:
			Dashboard tables are positional.
			The number and order of:
			- table headers
			- Cargo query fields
			- row template cells
			MUST match exactly.

			Only the first column (Code) is clickable and leads to the edit form.
			All other columns are displayed as plain text to prevent navigation to record pages.

			= Row transclusion Template =
			Template:PlaceRow
			<pre>
			<includeonly>
			\|-
			\| {{#formlink:
			form=Place
			\|target={{{_pageName}}}
			\|link text={{{_pageTitle}}}
			\|returnto=Dashboard:Place
			}}
			\| {{{Label}}}
			\| {{{Type}}}
			\| {{#if:{{{Parent\|}}}\|{{#titleparts:{{{Parent}}}\|1}}\|—}}
			\| {{#if:{{{Latitude}}}{{{Longitude}}}\|
			[https://www.openstreetmap.org/?mlat={{{Latitude}}}&mlon={{{Longitude}}} 🗺️]
			\| — }}
			</includeonly>
			</pre>

			Parent values are displayed as plain text (not links) to prevent users from navigating directly to record pages. All record editing is performed via forms accessed from the dashboard.

			= Javascript =
			Multiple JavaScript functions are used to:
			- auto-purge dashboards
			- fill coordinates based on address input
			- provide OpenStreetMap links
			- enforce mandatory fields at save time

			MediaWiki:Common.js
			<pre>
			[unchanged JavaScript content]
			</pre>

			All entity templates must define a Label field, which is treated as mandatory by the shared JavaScript logic.

			All Place pages are stored in the Place namespace with the page name acting as the Code.

			Example:
			<pre>
			{{Place
			\|Label=Brussels
			\|Parent=EURO
			\|Type=City
			\|Address=Brussel
			\|Latitude=50.8467372
			\|Longitude=4.3524930
			\|Notes=Nihil
			}}
			</pre>

			Such pages are configuration pages and must be accessed via the dashboard, not directly.

			== References: ==

			* [[mediawikiwiki:Extension:Cargo/Storing_data\|Cargo table explanation]]
			* [[mediawikiwiki:Extension:Page_Forms\|Page Forms explained]]

			[[Category:FinalConfig]]

Mngr at 11:08, 17 February 2026

2026-02-17T11:08:27Z

Show changes

Mngr at 20:30, 16 February 2026

2026-02-16T20:30:07Z

← Older revision		Revision as of 20:30, 16 February 2026
Line 56:		Line 56:

	Once the template is created don't forget to manually force the creation of the Cargo table.		Once the template is created don't forget to manually force the creation of the Cargo table.
	If modifications are done to the table, one needs to manually update the table and then go to the Cargo interface to swap the temporary table to become the official one. Take care what is inside and outside		If modifications are done to the table, one needs to manually update the table and then go to the Cargo interface to swap the temporary table to become the official one. Take care what is inside and outside.
			The field Code stores the full page name (including namespace) to ensure unambiguous identification and safe use as a foreign key across entities.

	Important Conventions:		Important Conventions:
Line 62:		Line 63:
	- Code field is used as the Page name		- Code field is used as the Page name
	- Dashboard will produce pages with this Cargo definition and a form to be hosted in a dedicated namespace Place:		- Dashboard will produce pages with this Cargo definition and a form to be hosted in a dedicated namespace Place:
			- The field name Label is mandatory in all entities and must not be renamed, as it is relied upon by shared JavaScript validation logic.


	Special lines in the bottom of the Template:		Special lines in the bottom of the Template:
Line 170:		Line 173:
	at the bottom. This is not a bug but a side effect too long to explain here.		at the bottom. This is not a bug but a side effect too long to explain here.

	Convention: The field Label ~~with a fieldname Name~~ is a mandatory ~~field~~ for all ~~our~~ entities ~~due to~~ the ~~use of code as pagename~~.		Convention: The field Label (displayed to the user as “Name”) is mandatory for all entities.
			This requirement is enforced via JavaScript at save time, not via the Page Forms mandatory option.
	However, it is not defined like this. A text informs the user about it, and a javascript is used to impose it, rather than the \|mandatory option as this generates a white box in the dark environment, difficult to use, and even more difficult to fix this via css for vector-2022 skin.		However, it is not defined like this. A text informs the user about it, and a javascript is used to impose it, rather than the \|mandatory option as this generates a white box in the dark environment, difficult to use, and even more difficult to fix this via css for vector-2022 skin.

Mngr at 20:25, 16 February 2026

2026-02-16T20:25:01Z

← Older revision		Revision as of 20:25, 16 February 2026
Line 7:		Line 7:
	This entity have a special feature: filling in the address will fill in automativcally the coordinnates and in dashboard you then have a link to openstreetmap. In order to realise this a javascript is an extra.		This entity have a special feature: filling in the address will fill in automativcally the coordinnates and in dashboard you then have a link to openstreetmap. In order to realise this a javascript is an extra.
	Also, as we use de facto Dark mode, we need to take some measures in order to avoid the system to give error messages with white boxes in this dark environment. Using Vector-2022 as a skin, it is very tricky to try to solves this modifying the Common.css, again a soluiton via Javascript was preferred.		Also, as we use de facto Dark mode, we need to take some measures in order to avoid the system to give error messages with white boxes in this dark environment. Using Vector-2022 as a skin, it is very tricky to try to solves this modifying the Common.css, again a soluiton via Javascript was preferred.
			This configuration deliberately favors explicit behavior and robustness over visual polish or implicit framework behavior, in order to ensure long-term maintainability.

	= Cargo Table: =		= Cargo Table: =

Mngr at 20:24, 16 February 2026

2026-02-16T20:24:00Z

← Older revision		Revision as of 20:24, 16 February 2026
Line 79:		Line 79:
	}}		}}
	</pre>		</pre>
	~~The first~~ lines ~~serves~~ the ~~purpose~~ of ~~TBD.~~..		These lines ensure that the human-readable name (Label) is consistently used as the visible title of the page, while the actual page name remains the technical identifier (Code).
	The last block is a preparation for the use of the openstreetmap.org. ~~it TBD~~...
			This decouples the stable identifier from the display name and allows renaming the label without breaking references, Cargo relations, or dashboards.

			The last block is a preparation for the use of the openstreetmap.org.
			This block conditionally displays a link to OpenStreetMap when valid geographic coordinates are available.

			The coordinates are normally filled automatically via JavaScript based on the Address field. This conditional display avoids broken or misleading map links when no coordinates are present.

	= Page Form: =		= Page Form: =

Mngr at 20:20, 16 February 2026

2026-02-16T20:20:19Z

← Older revision		Revision as of 20:20, 16 February 2026
Line 418:		Line 418:
	});		});
	</pre>		</pre>
			The javasripts are designed to be useful for all pages in the website.
			The entity pages Template:entity should take care to define Label as a field that is considered mandatory via the javascript.

	All this creates pages in the namespace Place with the name being the code. The page is a configuration to serve in Page Forms extension. Below is an example of such a page.		All this creates pages in the namespace Place with the name being the code. The page is a configuration to serve in Page Forms extension. Below is an example of such a page.

Mngr at 20:13, 16 February 2026

2026-02-16T20:13:31Z

@@ Line 61: / Line 61: @@
 - Code field is used as the Page name
 - Dashboard will produce pages with this Cargo definition and a form to be hosted in a dedicated namespace Place:
 = Page Form: =

Mngr at 20:10, 16 February 2026

2026-02-16T20:10:13Z

← Older revision		Revision as of 20:10, 16 February 2026
Line 56:		Line 56:
	Once the template is created don't forget to manually force the creation of the Cargo table.		Once the template is created don't forget to manually force the creation of the Cargo table.
	If modifications are done to the table, one needs to manually update the table and then go to the Cargo interface to swap the temporary table to become the official one. Take care what is inside and outside		If modifications are done to the table, one needs to manually update the table and then go to the Cargo interface to swap the temporary table to become the official one. Take care what is inside and outside
	~~<pre>~~

	~~</pre>~~

	Important Conventions:		Important Conventions:

Mngr at 20:08, 16 February 2026

2026-02-16T20:08:11Z

← Older revision		Revision as of 20:08, 16 February 2026
Line 10:		Line 10:
	= Cargo Table: =		= Cargo Table: =
	Template:Place		Template:Place
	~~<pre>~~

	~~</pre>~~

	~~Once the template is created don't forget to manually force the creation of the Cargo table.~~
	If modifications are done to the table, one needs to manually update the table and then go to the Cargo interface to swap the temporary table to become the official one. Take care what is inside and outside
	<pre>		<pre>
	<noinclude>		<noinclude>
Line 58:		Line 52:
	[https://www.openstreetmap.org/?mlat={{{Latitude}}}&mlon={{{Longitude}}} View on OpenStreetMap]		[https://www.openstreetmap.org/?mlat={{{Latitude}}}&mlon={{{Longitude}}} View on OpenStreetMap]
	}}		}}
			</pre>

			Once the template is created don't forget to manually force the creation of the Cargo table.
			If modifications are done to the table, one needs to manually update the table and then go to the Cargo interface to swap the temporary table to become the official one. Take care what is inside and outside
			<pre>

	</pre>		</pre>

Mngr at 20:06, 16 February 2026

2026-02-16T20:06:26Z

Show changes