TopLevel DomainsEdit.php - jcobban/Genealogy GitHub Wiki
This script displays the page summarizing the next level of administrative units that are defined within a particular country. For example for the United States of America this is the states and territories, for Canada this is the provinces and territories, for the United Kingdom this is states and province (but excludes Crown domains such as the Isle of Man), and for France this is the Metropolitan and Overseas Regions. You get to this script for a particular country from CountriesEdit.php.
When invoked by method='get' it supports the following parameters:
| parameter | description |
|---|---|
| 'cc' | the ISO 3166-1 2-character code for the country |
| 'lang' | the locale identifier as an IETF BCP 47 code. |
| 'partof' | this is used to request a display of 2nd-level administrative units within a 1st-level state within a country |
| 'offset' | If there are too many matching entries to display this specifies the offset within the set |
| of Domains to start the display. The default is 0, to start at the beginning of the set. | |
| 'limit' | This specifies the maximum number of entries to display at once. The default is 20. |
When an update of the table is requested this script is invoked using method="post" with the following parameters. Parameters which apply to a specific Domain end with the identifier of the Domain as 2 or more upper case letters, represented by @@ in the following:
| parameter | description |
|---|---|
| 'cc' | the ISO 3166-1 2-character code for the country |
| 'lang' | the locale identifier as an IETF BCP 47 code. |
| 'partof' | this is used to request a display of 2nd-level administrative units within a 1st-level state within a country |
| 'offset' | If there are too many matching entries to display this specifies the offset within the set |
| of Domains to start the display. The default is 0, to start at the beginning of the set. | |
| 'limit' | This specifies the maximum number of entries to display at once. The default is 20. |
| 'code@@' | The domain identifier, the first 2 characters of which are the country code. The value may contain a hyphen separating the country code portion from the state identifier portion. The value is what the user entered. If it is different from the value in the identifier, represented by @@, then the user has changed the domain identifier. |
| 'rowlang@@' | The language used for the Name of the Domain. The implementation supports having multiple names for each Domain. For example in Canada and France both English and French names for the Domains are defined. |
| 'name@@' | The name of the domain identified by the code in the language defined in parameter 'rowlang@@'. |
| 'partof@@' | The identifier of the Domain of which this Domain is a part. For top level Domains, for example states in the United States of America or provinces in Canada, this is the ISO 3166 country identifier. |
| 'category@@' | A string describing the type of Domain. For example this may be used to distinguish whether a Domain is a 'State' or a 'Territory'. |
| 'resourcesurl@@' | The URL of a page containing links to high-level genealogical resources for the Domain. |
This script displays a dialog such as:
Next: genealogy.js