Difference between revisions of "Admin Languages"
Robinrichm (talk | contribs) (mod version 12b, with v5 of the shared mod include files) |
Robinrichm (talk | contribs) (complete update for TNGv13) |
||
(One intermediate revision by the same user not shown) | |||
Line 3: | Line 3: | ||
| 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_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 = <div>[[Media:admin_languages_v12.0.0.4b.zip|12.0.0.4b.zip]]{{Tv120}}</div> | + | | download_link = [[Media:admin_languages_v13.0.0.6.zip|13.0.0.6.zip]]{{Tv130}} |
+ | <div class='clear:both">[[Media:admin_languages_v12.0.0.4b.zip|12.0.0.4b.zip]]{{Tv120}}</div> | ||
<div style='font-size:90%;'>See the [[#Revision_History|Revision History]] for older versions</div> | <div style='font-size:90%;'>See the [[#Revision_History|Revision History]] for older versions</div> | ||
| download_stats = | | download_stats = | ||
Line 11: | 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 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 == | == Visualizations == | ||
Line 72: | Line 82: | ||
== Revision History == | == Revision History == | ||
− | + | ||
{| border="0" cellspacing="1" cellpadding="2" class="wikitable" | {| border="0" cellspacing="1" cellpadding="2" class="wikitable" | ||
|- | |- | ||
! Mod Version !! TNG Versions !! Date !! Note | ! Mod Version !! TNG Versions !! Date !! Note | ||
+ | |- 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;" <!-- ############################################################## --> | |- style="vertical-align:top;" <!-- ############################################################## --> | ||
| [[Media:admin_languages_v12.0.0.4b.zip|12.0.0.4b]] | | [[Media:admin_languages_v12.0.0.4b.zip|12.0.0.4b]] | ||
Line 128: | 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
- An Inner Mod Menu, which provides handy links from TNG pages directly to mod documentation and a mod's Mods Settings Block. (Inner Mod Menus are visible only to TNG Admins; never to end users.)
- The Mods Used feature, which captures a list of mods that affected the code used to display a TNG page. (This is analogous to the Mod Manager Analyzer feature that reports which mods affect a given TNG file, but that applies at run-time.
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 |