Difference between revisions of "Admin Languages"

From TNG_Wiki
Jump to navigation Jump to search
(12 intermediate revisions by 4 users not shown)
Line 3: Line 3:
 
|  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 and Add New forms into one screen
 
| mod_validation  =  
 
| mod_validation  =  
| download_link  =  <div>[[Media:admin_languages_v11.0.0.4.zip|11.0.0.4.zip]]{{Tv110}}</div>
+
| mod_last_update = 30 Sep 2019
<div>[[Media:admin_languages_v10.1.0.3.zip|10.1.0.3.zip]]{{Tv1010}}</div>
+
| download_link  =  <div>[[Media:admin_languages_v12.0.0.4a.zip|12.0.0.4a.zip]]{{Tv120}}</div>
<div>You'll need to download and install [[Media:admin_languages_repair_v10.1.0.0.zip|admin_languages_repair_v10.1.0.0.zip]] after uninstalling Admin Languages v10.1.0.2</div>
 
 
| download_stats  =
 
| download_stats  =
 
| mod_author      = [[User:Robinrichm|Robin Richmond]]
 
| mod_author      = [[User:Robinrichm|Robin Richmond]]
Line 11: Line 10:
 
| 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.0.0.4
+
| mod_version    = 12.0.0.4a
| min_TNG_ver    = 11.0
+
| min_TNG_ver    = 10.1
| max_TNG_ver    = 11.1.2+
+
| max_TNG_ver    = 12.2
 
|  TNG_file_list  = admin_languages.php, English cust_text.php
 
|  TNG_file_list  = admin_languages.php, English cust_text.php
 
| related_mods  =  
 
| related_mods  =  
 
| notes    =  This mod makes admin_addlanguage.php and admin_editlanguage.php obsolete
 
| 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.
 
{| style="margin-right:0.5 em;" align="right"  
 
{| style="margin-right:0.5 em;" align="right"  
 
| __TOC__
 
| __TOC__
 
|}
 
|}
== Purpose of the Mod ==
+
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. 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 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.
 
# 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"
 
| __TOC__
 
|}
 
  
 
== 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 38: Line 35:
 
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==
+
== Mod Conflicts ==
 
No other mods affect admin_languages.php.
 
No other mods affect admin_languages.php.
  
==Requirements==
+
== Installation ==
* A working TNG installation.
+
This mod uses the standard installation procedure, though it should be noted that 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.<br>{{RobinInstallationBoilerplate}}
* An installed current version of the [[Mod Manager]].
+
== Visualizations ==
==Automated Installation==
 
# 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]].
 
 
 
== In the event of a problem ==
 
# 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 ==
 
  
 
{| border="1" cellspacing="1" cellpadding="2" class="wikitable"
 
{| border="1" cellspacing="1" cellpadding="2" class="wikitable"
Line 83: Line 69:
 
|}
 
|}
  
== Mod Change History ==
+
== Revision History ==
 
<span color='red'>'''*** The newest version is at the top of this table ***'''
 
<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_v12.0.0.4a.zip|12.0.0.4a]]
! Note
+
| 12.0 - 12.2+
|-  
+
| 30 Sep 2019
| 11.0.0.4
+
| No functional changes.
 +
*Moved a text string to cust_text.php,
 +
*Placed my "Inner Mod Menu" drop-down at the right end of the standard TNG Inner Menu.
 +
|- style="vertical-align:top;"  <!-- ############################################################## -->
 +
| [[Media:admin_languages_v12.0.0.4.zip|12.0.0.4]]
 +
| 12.0+
 +
| 4 May 2018
 +
| No functional changes; made compatible with TNGv12.
 +
|- style="vertical-align:top;"  <!-- ############################################################## -->
 +
| [[Media:admin_languages_v11.0.0.4.zip|11.0.0.4]]
 
| 11.0 - 11.1.2+
 
| 11.0 - 11.1.2+
 
| 1 Dec 2017
 
| 1 Dec 2017
 
| - Removed a comment line from the cust_text.php target locations search strings<br>
 
| - Removed a comment line from the cust_text.php target locations search strings<br>
- Updated for TNGv11, which added a field to the Languages table.<br>
+
- Updated the mod for TNGv11, which added a field to the Languages table.<br>
- Added comments to remaining 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 142: Line 137:
 
| EN, DE, RU
 
| EN, DE, RU
 
|}
 
|}
 +
[[Category:Mods for TNG v11]] [[Category:Mods for TNG v12]]
 
[[Category:Mods for TNG v10]]
 
[[Category:Mods for TNG v10]]
 
[[Category:admin_languages.php mods]]
 
[[Category:admin_languages.php mods]]
[[Category:cust_text.php mods]]
+
[[Category:cust_text.php English mods]]

Revision as of 11:24, 1 December 2019

Admin Languages
Summary Simplifies the entry of languages by combining the Search and Add New forms into one screen
Validation
Mod Updated 30 Sep 2019
Download link
12.0.0.4a.zip
TNG 12.0
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 12.0.0.4a
Min TNG V 10.1
Max TNG V 12.2
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.

Mod Conflicts

No other mods affect admin_languages.php.

Installation

This mod uses the standard installation procedure, though it should be noted that 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

*** The newest version is at the top of this table ***

Mod Version TNG Versions Date Note
12.0.0.4a 12.0 - 12.2+ 30 Sep 2019 No functional changes.
  • Moved a text string to cust_text.php,
  • Placed my "Inner Mod Menu" drop-down at the right end of the standard TNG Inner Menu.
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 11.0.0.4 11.1.2 English
MOTYER Family Genealogy John Mark Motyer Public site see here see here EN, DE, RU