translationwizard
Navigation Home Module Vault Translations Modules Readme_first translationwizard	This is the Translation Wizard, a module to greatly enhance the work with translating your server. == History == Formerly the untranslated.php filled the needs for a quick program that used the newly invented [[Translation Engine|translation engine]], which was capable of replacing almost any text in the LotGD game. It yet had usage flaws, means it was a long work if you wanted to have all of your game translated with it. Please seperate this from the enclosed [[Translator_Tool|translatortool.php]], this is another function only responsible for the nice T's you get once you enabled the [[Translator Flag]] for your account. == Author == The untranslated.php provided the base for the Wizard, henceforth [[User:XChrisX|Christian Rutsch (XChrisX)]] is the original author, but the wizard itself was developed by [[User:Nightborn|Oliver Brendel (Nightborn)]]. == Requirements == === LotGD Version === Basically it should work on any 1.x.x version. Add-Ons: *Wizard in 1.1.0 makes use of the new coding scheme which enables you to translate non-latin charsets === Personal Requirements === Before you as main admin go on and simply install the wizard, make *sure* you have read: *[[Translation FAQ (Admins)]] ====Note==== If you want to code modules and make them translation ready, read: *[[Translation FAQ (Coders)]] == Installation == Just like any other module: *Copy the contents WITH folder structure to your modules directory (means you should have then also a modules/translationwizard folder) *Go into your game -> [[Grotto|Grotto]] -> [[Manage Modules]] *Click "Install" in the row of the translation wizard to install it. *Click "Activate" in the row of the translation wizard (you are now in the Administrative category). == Usage == *To use the wizard, you must have the [[Translator Flag]] turned on for your character. *Make sure newbie island does not block it (normally not in >= LotGD 1.1.0) *If you have changed any standard settings of the wizard, like "Restricted Access" turned on, make sure your character has the [[Preferences|preference]] set correctly. *If you want to use more than the basic features, click "Switch to advanced view" to see the expert functions == Wizard Settings == ===Block the Untranslated Text in the grotto=== ''Default: Off'' Blocks the "Untranslated Text" navigation in the grotto. Normally you can turn this on as the wizard replaces the complete functionality. ===Block the Central Translations Section in the wizard=== ''Default: Off'' Blocks the ability to pull&push translations (what these functions do is is explained [[Translation Wizard#Functions|here]]). Also the entire block won't be displayed. ===Use nested query (don't works with lower mysql servers)=== ''Default: Off'' Use this if you have MySQL >=4.1.x and want to use it. Normally you can leave it turned off. ===How many results per page for fixing/checking=== ''Default: 20'' How many single rows are displayed when using fix/check or insert. ===Has the wizard restrictions for some users?=== (Restrictions are: search+edit the translations table + truncate untranslated) ''Default: Off'' It is recommended to turn it on once you don't do all by yourself. Else someone might make with search+replace junk out of your translations table. ===Scan automatically modules upon install and insert into untranslated=== ''Default: Off'' ''Only for skilled users'' Does what it says... scans (using the internal scan function) the main file (only) and inserts the found parts to your untranslated table. ===Ask if translations should be deleted at uninstallation of a module=== ''Default: Off'' If you hit "Uninstall" in the modules section of the grotto, you will be asked if you want to remove the translation associated with this module scheme from your translations table. ==Functions== ===Switch to simple/advanced view === This lets you select a basic view of the functions on the left hand sidebar or a view for more experienced users showing all options. Normally, as a starter, you should only need the basic view of the wizard's functions. ===Operations=== ====Overview==== Overview gives you a brief overview over your current translations,pulled translations and untranslated tables. It is more of a statistic function. ====Restart Translator==== Restart Translator lets you start the translator with a random pattern of translations. You will have two boxes and get after each save a new to-do-translation. Good if you just want to do random stuff and don't care for fully translated modules. ====Translate by Namespace==== Translate by Namespace lets you have a pulldown menu for the module/file the translation originates from. You can edit/delete single or multiple untranslated rows in the untranslated table for the selected module. ====Check for duplicate entries==== Check for duplicate entries checks your translations table for duplicate rows, which means it checks for intext=intext AND namespace=namespace AND language=language. The outtext may differ. You can delete automatically all duplicate rows or manually one-by-one. In some cases, you have to repeat the procedure to make your translations table free of these entries. ====Fix already translated==== Fix already translated means all entries in the untranslated table with matching intext,language and namespace like a row in the translations table will be deleted. This prevents double translations. ====Truncate untranslated table==== Truncate untranslated table wipes your untranslated table clear, like the name suggests. ====Check for known translations==== Check for known translations will check if any intext from the untranslated table occurs in the translations table with ANY namespace yet language=language. You will get a list of entries you can either delete, choose which translation you want to use or edit+insert a translation. The delete function refers to the entry in the untranslated table, so nothing will be deleted from your translations table. ====Search+Edit the translations table==== Seach+Edit the translations table will let you search and edit (even delete) entries in your translations table. Useful if you want to correct a misspelled translation or the like. ====Delete empty namespace rows from untranslated==== Deletes rows that are inserted into the untranslated table and who have no namespace [[ ===Central translations === ====Pull==== Pull lets you select what namespaces (based on your installed modules) to pull into a pulled translations table (which is created once you install this wizard). This is the first action for you if you want to fill or complete your translations table via central translations. You may first select a folder from the pulldown menu (may be different ones even for one language) and then "pull dates" which means you get for all your existing modules/[[Translation Schema|translation schemes]] the timestamp and can check if there were updates. If you want to Pull, you can check a few and "Pull checked"... if you want to "pull only for those in the untranslated" you need to check if you have something in your untranslated table. (Check for the [[Settings|text collection in your game settings]]) ====Push==== Push shows a namespace of your liking ready to paste in a file. The file is ready to get pulled. (Do this if you want to send your translations in). Additionally you can have it put into your cache directory (again, [[Settings|Game Settings]] -> Datacache) and then you can grab it via ftp and send it to [[User:Nightborn]] or someone responsible for your language). ====Insert missing translations==== Insert missing translations will insert any row from the pulled translations table you don't have with intext,language,namespace yet in your translations table. ====Check for known translations==== Check for known translations works like the other one, except that it checks with the pulled. You can pull some namespaces and then click yourself through. This would be if you don't want to insert anything automatically. ====Truncate pulled translations==== Truncate pulled translations table wipes your pulled table clear, like the name suggests. ===Change scheme=== ====Change translation scheme==== Change translation scheme will select you the language you want to translate for. This won't effect some operations like fixing your translations table or deleting duplicates. ===Show Versionlog=== Shows the version log also available in this wiki. ===Scan Modules=== '''Expert Feature!''' Modulescanner (Functions by [[Edorian]]). This can scan files for translatable parts (not 100%! Some things can only be decided at the runtime of the program). You can also use it to scan a file + edit all of its parts, not only those not yet translated. ==Version Changelog== ===Version Changes to 1.01=== fixed nav, only showing for translators ===Version Changes to 1.02=== added checkbox-based mass-translations, also made intext fields readonly to prevent stupid user mistakes :-P ===Version Changes to 1.03=== added pref to block nav ===Version Changes to 1.04=== minor fix causes by edit one entry -> want to check others and missing buttons ===Version Changes to 1.05=== forgot two httppost in critical parts ===Version Changes to 1.06=== new structure with clear switches and some comments ===Version Changes to 1.07=== added pref what scheme for translation you want to use ===Version Changes to 1.08=== added "truncate untranslated table" ===Version Changes to 1.09=== added an option to delete all entries in untranslated that occur with namespace,language,intext exactly in untranslated (just to make sure...) (if this would be done automatically, it would just cost valuable server time) ===Version Changes to 1.10=== mayor increase in code: added "delete duplicate entries" which selects entries who occurr more than once in your translations table (due to an error or a wrong insert) the sql query take a second or so... but may take very long if you have a few thousand rows to fix... I hope the code is okay, it was quite a bit of work. ===Version Changes to 1.11=== now you can select & delete from the untranslated table, also added a delete button to single rows ===Version Changes to 1.12=== case-insensitive ones would have been selected in some cases and most importantly deleted in some cases (duplicate entries i.e.) fixed by XChrisX ===Version Changes to 1.13=== minor bugfixes, mostly rearrangements ===Version Changes to 1.14=== new query for the already translated parts, new site for this thanks to -Torne- ===Version Changes to 1.15=== fixed addnav that was displayed even if the module was inactive, thanks to -theKlaus- ===Version Changes to 1.16=== now displays tables when fixing already translated or checking for double entries, thanks to -Mindbender- ===Version Changes to 1.17=== ...had fun with javascript... the *select all* works now also as deselect all with a button that changes text... as well as I removed the show button for the namespace selection and had a onChange that does the same but is more comfortable - thanks to XChrisX for his valuable help- ===Version Changes to 1.18=== I made many things selectable... the duplicate rows can now be deleted manually too... and you have a new function where you can just *click* in new translations if exactly the same phrase as intext occurrs in the translations -thanks to Mindbender for the idea- ===Version Changes to 1.19=== added a delete option for the 1-click-translations of known modules and a minor bugfix (too many addslashes) ===Version Changes to 1.20=== optimized the query, now it's going to be a bit better and made pages -thanks to XChrisX- ===Version Changes to 1.21=== bugfix with known - delete&choose... `% and %s ===Version Changes to 1.22=== minor fix: default wrong stated als "true" with a bool variable..should be 1 or respective 0 -thanks to XChrisX- ===Version Changes to 1.23=== rewritten some routings: delete/choose links due to failures with slashes and the like -thanks to XChrisX- ===Version Changes to 1.24=== rewritten the structure to a more fast-loading one. using own directory now with separate files for each function -thanks to XChrisX- ===Version Changes to 1.25=== added the help page, overview and the user-pref for a language schema -thanks to Mindbender- ===Version Changes to 1.26=== added the central translations *mayor feature* ===Version Changes to 1.27=== minor changes to the central translations, adapted alterations from theKlaus and Mindbender ===Version Changes to 1.28=== minor change: added an Edit+Insert Button to both known sections -thanks to Mindbender- ===Version Changes to 1.29=== minor changes: added a error handling to the known sections, added a new query for insert_central -thanks to Torne- ===Version Changes to 1.30=== feature added: Search+Edit Translations... just if somebody tells you where something is translated wrongly, you can fetch and edit/delete that row. ===Version Changes to 1.31=== the last query is now repeated by the search+edit...as well as this versioninfo is now out of the main file :) just to save a bit space if the wizard is called. ===Version Changes to 1.32=== well, two new things: "search+replace" (like a text function where you can select and then replace text within) and the "scan modules" function...it fetches most, but not all and maybe wrong, but you *can* scan modules now ;) new modules i.e. and get all text in it without having users to play through -big thanks to Sichae+XChrisX- ===Version Changes to 1.33=== made some minor changes... removed the switch to untranslated scheme... (makes no sense now)... as well as I added the coding scheme to the wizard for the htmlentities command. Now it's working... for russian or other coding tables too. ===Version Changes to 1.34=== minor coding changes, as well as I added "Next Page" and "Previous Page" to the search+edit/search+replace/known/known central sections ===Version Changes to 1.35=== added a simple/advanced view, merged the known/known_central and the truncate/truncate_central ===Version Changes to 1.36=== added a quick insert function to the known section ===Version Changes to 1.37=== little fixes and a "all dump" button in the push section, goes to datacache dir ===Version Changes to 1.38=== dohook into a seperate file and a new feature: autoscan upon installation and insert the rows into the untranslated. automates the process in a way. also provided the scan functions in two functions now. -thanks to Mindbender for the idea and XChrisX for the hook- ===Version Changes to 1.39=== added a delete when uninstalling one or more module(s) -> delete translations too optionally. Added radiobuttons to the known section. Errorhandler in first stage to notify. ===Version Changes to 1.40=== filescanparser writting by Edorian now in place, also enhanced the scanning functions: now scans subdirs for files, different scheme manually setable, scanning of lib files that carry the modulename in the path or the file itself automatically, already translated parts in a file will be shown and you can edit this translation directly from the scan part, also direct edit&insert from the scan possible (also mixed with already translated ones) etc - thx to Edorian - ===Version Changes to 1.41=== switched to Administrative section + coding scheme now taken from the lotgd core - if you don't have Version 1.1.0, you will only be able to work with ISO-8859-1... or you edit the translationwizard.php =) but please consider an update ===Version Changes to 1.42=== added the possibilty to clean up empty namespace rows in the untranslated - idea by Edorian - ===Version Changes to 1.43=== added the invalidate for the cached translation queries in 1.1.x and a fix for the scan module regarding addnews ===Version Changes to 1.44=== serveral smaller bugfixes and adaption to new language settings in 1.1.1 (compatible downwards) ===Version Changes to 1.45=== added mirrors to the pull section (grabbed from my central db server), fixed one missing /option in the pull.php ===Version Changes to 1.46=== added a setting for the central db server - as the location changed. Also minor cleanups Click for Download