Difference between revisions of "Admin Languages"
Robinrichm (talk | contribs) |
Robinrichm (talk | contribs) (complete update for TNGv13) |
||
(9 intermediate revisions by 4 users not shown) | |||
Line 1: | Line 1: | ||
{{TNGmod | {{TNGmod | ||
| mod_name = Admin Languages | | mod_name = Admin Languages | ||
− | | mod_summary = Simplifies the entry of languages by combining the Search and Add New forms into one screen | + | | mod_summary = Simplifies the entry of languages by combining the Search, Edit, and Add New forms into one screen, and provides more meaningful prompts for languages and character sets. |
| mod_validation = | | mod_validation = | ||
− | | mod_last_update = | + | | mod_last_update = 06 Oct 2020 |
− | | download_link = | + | | download_link = [[Media:admin_languages_v13.0.0.6.zip|13.0.0.6.zip]]{{Tv130}} |
− | <div>[[Media: | + | <div class='clear:both">[[Media:admin_languages_v12.0.0.4b.zip|12.0.0.4b.zip]]{{Tv120}}</div> |
− | <div>[[ | + | <div style='font-size:90%;'>See the [[#Revision_History|Revision History]] for older versions</div> |
| download_stats = | | download_stats = | ||
| mod_author = [[User:Robinrichm|Robin Richmond]] | | mod_author = [[User:Robinrichm|Robin Richmond]] | ||
Line 12: | Line 12: | ||
| mod_contact = [http://www.robinrichmond.com/mod_support.php My Mod Support form] | | mod_contact = [http://www.robinrichmond.com/mod_support.php My Mod Support form] | ||
| mod_support = [http://www.robinrichmond.com/family/mod_support.php My Mod Support form] or [http://tng.community/ TNG Community Forums] | | mod_support = [http://www.robinrichmond.com/family/mod_support.php My Mod Support form] or [http://tng.community/ TNG Community Forums] | ||
− | | mod_version = | + | | mod_version = 13.0.0.6 |
| min_TNG_ver = 10.1 | | min_TNG_ver = 10.1 | ||
− | | max_TNG_ver = | + | | max_TNG_ver = 13 |
| TNG_file_list = admin_languages.php, English cust_text.php | | TNG_file_list = admin_languages.php, English cust_text.php | ||
| related_mods = | | related_mods = | ||
Line 20: | Line 20: | ||
}} | }} | ||
== Purpose of the Mod == | == Purpose of the Mod == | ||
− | This mod improves workflow by combining the Search, Add New, and Edit forms into one screen. The mod also enhances the Add New Language form to come up with more meaningful values for the Display Language and Character Set fields | + | This mod improves workflow by combining the Search, Add New, and Edit forms into one screen. The mod also enhances the Add New Language form to come up with more meaningful values for the Display Language and Character Set fields. |
− | |||
− | |||
{| style="margin-right:0.5 em;" align="right" | {| style="margin-right:0.5 em;" align="right" | ||
| __TOC__ | | __TOC__ | ||
|} | |} | ||
+ | That is, depending on which language folder is selected by the user, | ||
+ | # The input box for the language display value (e.g. German vs Dutch vs German-UTF8, etc.) may be converted into checkboxes that populate an input box into which the user can ultimately enter an arbitrary value. | ||
+ | # The input box for the character set is initialized to "UTF-8" for all UTF8 language folders, to "ISO-8559-2" for Czech and Polish, and to "ISO-8559-1" for all other language folders. | ||
== Mod Version 2 Uninstallation == | == Mod Version 2 Uninstallation == | ||
− | Admin Languages v10.1.0.2 (i.e. v2) contains some ambiguous code fragments in two target locations, and thus does not uninstall correctly. It | + | Admin Languages v10.1.0.2 (i.e. v2) contains some ambiguous code fragments in two target locations, and thus does not uninstall correctly. It uninstalls without error, but it leaves an incorrect string in the PHP program admin_languages.php so that admin_languages.php neither works correctly, nor allows the Admin Languages mod to be re-installed. |
After uninstalling Admin Languages v2, you can repair admin_languages.php either by | After uninstalling Admin Languages v2, you can repair admin_languages.php either by | ||
Line 36: | Line 37: | ||
And by all means, delete Admin Languages v2 once you have uninstalled it. | And by all means, delete Admin Languages v2 once you have uninstalled it. | ||
− | == | + | == Other Mods == |
+ | == Conflicts == | ||
No other mods affect admin_languages.php. | No other mods affect admin_languages.php. | ||
+ | == Related Mods == | ||
+ | <ol> | ||
+ | <li>{{RobinBoilerplate | text=imm}}</li> | ||
+ | <li>{{RobinBoilerplate | text=smn}}</li> | ||
+ | </ol> | ||
− | ==Installation== | + | == Installation == |
− | = | + | {{RobinBoilerplate | text=language}} |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | == | + | '''In mod version 12.0.0.4b and earlier''', this mod contains a mod subfolder that is shared with other mods that implement '''[https://tng.lythgoes.net/wiki/index.php?title=Inner_Mod_Menus Inner_Mod_Menus]'''. Because of the shared subfolder, as you unzip or copy the mod, you might get a warning noting that a file or folder already exists. You can just ignore that warning. |
+ | {{RobinInstallationBoilerplate| install}} | ||
+ | |||
+ | == Visualizations == | ||
{| border="1" cellspacing="1" cellpadding="2" class="wikitable" | {| border="1" cellspacing="1" cellpadding="2" class="wikitable" | ||
Line 81: | Line 81: | ||
|} | |} | ||
− | == | + | == Revision History == |
− | + | ||
{| border="0" cellspacing="1" cellpadding="2" class="wikitable" | {| border="0" cellspacing="1" cellpadding="2" class="wikitable" | ||
|- | |- | ||
− | ! Mod Version | + | ! Mod Version !! TNG Versions !! Date !! Note |
− | ! TNG | + | |- style="vertical-align:top;" <!-- ############################################################## --> |
− | ! | + | | [[Media:admin_languages_v13.0.0.6.zip|13.0.0.6]] |
− | ! | + | | 13 |
− | |- | + | | 20 Sep 2020 |
+ | | | ||
+ | * Had to undo the effects of the new TNGv13 "Save+Stay" buttons on admin_newlanguage.php and admin_updatelanguage.php | ||
+ | * Upgraded the success message to include the language folder and encoding. | ||
+ | * Upgraded to the TNGv13 version of the Inner Mod Menu Mod. | ||
+ | |||
+ | |- style="vertical-align:top;" <!-- ############################################################## --> | ||
+ | | [[Media:admin_languages_v12.0.0.4b.zip|12.0.0.4b]] | ||
+ | | 12.0 - 12.3 | ||
+ | | 28 Mar 2019 | ||
+ | | No functional changes. | ||
+ | * Adds my Inner Mod Menu, and cleans up some language strings. | ||
+ | |||
+ | |- style="vertical-align:top;" <!-- ############################################################## --> | ||
| [[Media:admin_languages_v12.0.0.4.zip|12.0.0.4]] | | [[Media:admin_languages_v12.0.0.4.zip|12.0.0.4]] | ||
| 12.0+ | | 12.0+ | ||
| 4 May 2018 | | 4 May 2018 | ||
| No functional changes; made compatible with TNGv12. | | No functional changes; made compatible with TNGv12. | ||
− | |- | + | |- style="vertical-align:top;" <!-- ############################################################## --> |
| [[Media:admin_languages_v11.0.0.4.zip|11.0.0.4]] | | [[Media:admin_languages_v11.0.0.4.zip|11.0.0.4]] | ||
| 11.0 - 11.1.2+ | | 11.0 - 11.1.2+ | ||
Line 102: | Line 115: | ||
- Inside the .cfg file, added comments to remaining some code fragment locations<br> | - Inside the .cfg file, added comments to remaining some code fragment locations<br> | ||
- DisplayModNames is now optional | - DisplayModNames is now optional | ||
− | |- | + | |- style="vertical-align:top;" <!-- ############################################################## --> |
| 10.1.0.3 | | 10.1.0.3 | ||
| 10.1.0 - 10.1.2 | | 10.1.0 - 10.1.2 | ||
| 18 Sep 2015 | | 18 Sep 2015 | ||
| Fixed the problem that causes version 2 to uninstall badly. Also defaults to ISO-8559-2 for Czech and Polish non-UTF language folders. | | Fixed the problem that causes version 2 to uninstall badly. Also defaults to ISO-8559-2 for Czech and Polish non-UTF language folders. | ||
− | |- | + | |- style="vertical-align:top;" <!-- ############################################################## --> |
| 10.1.0.2 | | 10.1.0.2 | ||
| 10.1.0 - 10.1.2 | | 10.1.0 - 10.1.2 | ||
| 12 Sep 2015 | | 12 Sep 2015 | ||
| Added the edit form to the Search & Add New page. Added logic to provide choices to populate the Display and Character Set fields. | | Added the edit form to the Search & Add New page. Added logic to provide choices to populate the Display and Character Set fields. | ||
− | |- | + | |- style="vertical-align:top;" <!-- ############################################################## --> |
| 10.1.0.1 | | 10.1.0.1 | ||
| 10.1.0 - 10.1.1 | | 10.1.0 - 10.1.1 | ||
Line 134: | Line 147: | ||
| [[User:Robinrichm|Robin Richmond]] | | [[User:Robinrichm|Robin Richmond]] | ||
| Mod developer | | Mod developer | ||
− | | | + | | 13.0.0.6 |
− | | | + | | 13 |
| English | | English | ||
|- | |- |
Revision as of 18:56, 10 October 2020
Admin Languages | |||
---|---|---|---|
Summary | Simplifies the entry of languages by combining the Search, Edit, and Add New forms into one screen, and provides more meaningful prompts for languages and character sets. | ||
Validation | |||
Mod Updated | 06 Oct 2020 | ||
Download link | 13.0.0.6.zip
12.0.0.4b.zip
See the Revision History for older versions | ||
Download stats | |||
Author(s) | Robin Richmond | ||
Homepage | Robin Richmond's Genealogy Database | ||
Mod Support | My Mod Support form or TNG Community Forums | ||
Contact Developer | My Mod Support form | ||
Latest Mod | 13.0.0.6 | ||
Min TNG V | 10.1 | ||
Max TNG V | 13 | ||
Files modified | admin_languages.php, English cust_text.php | ||
Related Mods | |||
Notes | This mod makes admin_addlanguage.php and admin_editlanguage.php obsolete |
Purpose of the Mod
This mod improves workflow by combining the Search, Add New, and Edit forms into one screen. The mod also enhances the Add New Language form to come up with more meaningful values for the Display Language and Character Set fields.
That is, depending on which language folder is selected by the user,
- The input box for the language display value (e.g. German vs Dutch vs German-UTF8, etc.) may be converted into checkboxes that populate an input box into which the user can ultimately enter an arbitrary value.
- The input box for the character set is initialized to "UTF-8" for all UTF8 language folders, to "ISO-8559-2" for Czech and Polish, and to "ISO-8559-1" for all other language folders.
Mod Version 2 Uninstallation
Admin Languages v10.1.0.2 (i.e. v2) contains some ambiguous code fragments in two target locations, and thus does not uninstall correctly. It uninstalls without error, but it leaves an incorrect string in the PHP program admin_languages.php so that admin_languages.php neither works correctly, nor allows the Admin Languages mod to be re-installed.
After uninstalling Admin Languages v2, you can repair admin_languages.php either by
- Restoring it from the original admin_languages.php in your TNG download, or
- Installing Admin Languages Repair, from the zip file listed on the right.
Once you have Installed Admin Languages Repair, you should just delete it; Do NOT Uninstall Admin Languages Repair. And by all means, delete Admin Languages v2 once you have uninstalled it.
Other Mods
Conflicts
No other mods affect admin_languages.php.
Related Mods
- Inner Mod Menus used to be implemented by a standalone mod named Inner Mod Menus, but they are now a feature of the Mod Settings Blocks mod. "Inner Mod Menus" are drop-down menus in the standard TNG "InnerMenu" and are visible only to TNG site administrators. They provide information about mods that affect a given program and links to the mod's settings (in Mod Settings Blocks).
- The old Show Mod Names mod has been retired. Its functionality (now called "Mods Used" is now implemented by the Mod Settings Blocks mod.
Installation
This mod includes a typical mod subfolder, with the same base name as the mod's .cfg file. The subfolder is atypical in that no files in it are installed to working TNG folders. However, it does contain critical files that contain the mod's language strings, which the mod does not add to standard cust_text.php files. Instead, the PHP code modified by this mod loads the language strings from files in the mod's languages/ subfolder. Read more about this technique.
In mod version 12.0.0.4b and earlier, this mod contains a mod subfolder that is shared with other mods that implement Inner_Mod_Menus. Because of the shared subfolder, as you unzip or copy the mod, you might get a warning noting that a file or folder already exists. You can just ignore that warning.
[Show Installation Details]
Requirements
- A working TNG installation.
- An installed current version of the Mod Manager.
- You should backup files listed in the panel on the right.
Procedure
- Remove and delete previous version of this mod.
- Backup the files updated by this mod. They are listed in the panel at the upper right.
- Download the .zip file, Extract its .cfg file to the mods folder.
- Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files.
Problems?
- Try using the Mod Manager Remove capability
- Contact me through My Mod Support form.
Visualizations
BEFORE Search |
|
BEFORE Add New |
|
AFTER: Combined Form |
|
AFTER: Combined Form - Edit |
|
AFTER: Add New form after a language folder has been selected | |
---|---|
File:Admin languages-after2.png | |
AFTER: There are fewer choices when the language name in English and in the selected language are the same (or when no translated language name is available). | |
AFTER: There is only one choice when a non-UTF language is chosen and the translated language name is the same as the English (or is unavailable) | |
Revision History
Mod Version | TNG Versions | Date | Note |
---|---|---|---|
13.0.0.6 | 13 | 20 Sep 2020 |
|
12.0.0.4b | 12.0 - 12.3 | 28 Mar 2019 | No functional changes.
|
12.0.0.4 | 12.0+ | 4 May 2018 | No functional changes; made compatible with TNGv12. |
11.0.0.4 | 11.0 - 11.1.2+ | 1 Dec 2017 | - Removed a comment line from the cust_text.php target locations search strings - Updated the mod for TNGv11, which added a field to the Languages table. |
10.1.0.3 | 10.1.0 - 10.1.2 | 18 Sep 2015 | Fixed the problem that causes version 2 to uninstall badly. Also defaults to ISO-8559-2 for Czech and Polish non-UTF language folders. |
10.1.0.2 | 10.1.0 - 10.1.2 | 12 Sep 2015 | Added the edit form to the Search & Add New page. Added logic to provide choices to populate the Display and Character Set fields. |
10.1.0.1 | 10.1.0 - 10.1.1 | 30 Apr 2015 | Initial release. |
Sites using this mod
If you download and install this mod, please add your site to the table below.
URL | User | Note | Mod-Version | TNG-Version | User-language |
---|---|---|---|---|---|
Robin Richmond's Genealogy Database | Robin Richmond | Mod developer | 13.0.0.6 | 13 | English |
MOTYER Family Genealogy | John Mark Motyer | Public site | see here | see here | EN, DE, RU |