Difference between revisions of "Admin Languages"

From TNG_Wiki
Jump to navigation Jump to search
(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 = 4 May 2018
+
| mod_last_update = 06 Oct 2020
| download_link  =  <div>[[Media:admin_languages_v12.0.0.4.zip|12.0.0.4.zip]]{{Tv120}}</div>
+
| download_link  =  [[Media:admin_languages_v13.0.0.6.zip|13.0.0.6.zip]]{{Tv130}}
<div>[[Media:admin_languages_v11.0.0.4.zip|11.0.0.4.zip]]{{Tv110}}</div>
+
<div class='clear:both">[[Media:admin_languages_v12.0.0.4b.zip|12.0.0.4b.zip]]{{Tv120}}</div>
<div>[[Media:admin_languages_v10.1.0.3.zip|10.1.0.3.zip]]{{Tv1010}}</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    = 10.1.0.3, 11.0.0.4, 12.0.0.4
+
| mod_version    = 13.0.0.6
 
| min_TNG_ver    = 10.1
 
| min_TNG_ver    = 10.1
| max_TNG_ver    = 12.0+
+
| 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. That is, depending on which language folder is selected by the user,
+
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.  
# 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.
 
 
{| 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 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.
+
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.
  
==Compatibility With Other Mods==
+
== 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 ==
===Requirements===
+
{{RobinBoilerplate | text=language}}
* A working TNG installation.
 
* An installed current version of the [[Mod Manager]].
 
===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, and 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_-_Installing_Config_Files#Remove_Mod_Steps|Mod Manager Remove]] capability
 
# Contact me through [http://www.robinrichmond.com/family/mod_support.php My Mod Support form].
 
  
== Visualization of this Mod ==
+
'''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:
 
|}
 
|}
  
== Mod Change History ==
+
== Revision History ==
<span color='red'>'''*** The newest version is at the top of this table ***'''
+
 
 
{| 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 Version
+
|- style="vertical-align:top;"  <!-- ############################################################## -->
! Date
+
| [[Media:admin_languages_v13.0.0.6.zip|13.0.0.6]]
! Note
+
| 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
| 11.0.0.4
+
| 13.0.0.6
| 11.1.2
+
| 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
TNG 13.0
12.0.0.4b.zip
TNG 12.0
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,

  1. 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.
  2. 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

  1. Restoring it from the original admin_languages.php in your TNG download, or
  2. 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

  1. 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).
  2. 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

  1. Remove and delete previous version of this mod.
  2. Backup the files updated by this mod. They are listed in the panel at the upper right.
  3. Download the .zip file, Extract its .cfg file to the mods folder.
  4. Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files.

Problems?

  1. Try using the Mod Manager Remove capability
  2. Contact me through My Mod Support form.
[Hide Details]

Visualizations

BEFORE
Search
Admin languages-before1.png
BEFORE
Add New
Admin languages-before2.png
AFTER:
Combined Form
Admin languages-after1.png
AFTER:
Combined Form - Edit
Admin languages-after-edit.png
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).
Admin languages-after3.png
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)
Admin languages-after4.png

Revision History

Mod Version TNG Versions Date Note
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.
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.
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.
- Inside the .cfg file, added comments to remaining some code fragment locations
- DisplayModNames is now optional

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