View Issue Details
| ID | Project | Category | View Status | Date Submitted | Last Update |
|---|---|---|---|---|---|
| 2048 | Composr | core | public | 2015-10-03 00:29 | 2015-10-04 00:59 |
| Reporter | Chris Graham | Assigned To | Chris Graham | ||
| Priority | normal | Severity | feature | ||
| Status | resolved | Resolution | fixed | ||
| Summary | 2048: Language string filtration | ||||
| Description | Objectives: a) Allow a higher-level of configurability within language strings, b) while retaining performance c) and not making language-specific assumptions about sentence structure via use of inflexible pre-conceived parameterisation strategories d) and not causing an explosion in the number of language strings translators need to deal with Allow language packs to include a filter.php file which contains a class like: class LangFilter_EN extends LangFilter { function compile_time($key, $value) { ... return $new_value; } function run_time($key, $value, $flag) { ... return $new_value; } } The compile_time method is called for each string when a language pack file is compiled into the cache. The run_time method is called for individual run-time lookups, but only if a string has been marked as needing it within the .ini file like... [runtime_processing] MISSING_RESOURCE=example (this says the "MISSING_RESOURCE" string would get extra processing, passing 'example' as the $flag value for it [useful for decentralised per-string configuration]) The language cache will need to store this meta-data efficiently. The default EN language pack would tackle the following concerns: 1) Translate the British English to American English, if a config option for this was enabled. 2) Replace "tick (check)" and "ticking (checking)" with just the appropriate word for British/American spelling. 3) Fix clunky language around contextual times, such as "Added on Today" -> "Added Today". 4) Replace the word 'resource' with a specific noun such as 'forum topic'. 5) Replace the word 'category' with a specific noun such as 'forum'. 6) Replace the word 'entry' with a specific noun such as 'gallery image'. 7) Replacing of "the software" with the specific configured brand name (usually "Composr"). Cases 4-6 must be handled in PHP as it would be naive to use regular string subtitutions via language string parameters. There is too much grammatical context in different languages to just clump words into compound sentences (gender, tense, etc). Document this system in the internationalisation tutorials. | ||||
| Tags | No tags attached. | ||||
| Attach Tags | |||||
| Time estimation (hours) | 10 | ||||
| Sponsorship open | |||||
|
|
Language strings containing generics... MISSING_RESOURCE=The requested resource does not exist. It has probably been deleted. _MISSING_RESOURCE=The requested resource (<kbd>{1}</kbd>) does not exist. It has probably been deleted. MISSING_RESOURCE_COMCODE=ERROR: A resource, {2}, requested within some Comcode (the {1} tag) does not exist. STOPPED_RECURSIVE_RESOURCE_INCLUDE=There seemed to have been a loop of resource includes of {1} (e.g. a resource, such as a page, includes itself). The loop has been stopped so the server does not crash. NOTIFICATION_TYPE_error_occurred_missing_resource=Missing resource referenced DESCRIPTION_AUTHOR=The author of this entry. DESCRIPTION_CATEGORIES=All the categories under which this entry will be referenced. DESCRIPTION_SECONDARY_CATEGORIES=Secondary categories under which this entry will additionally be referenced. DESCRIPTION_ALLOW_RATING=Whether to allow users to rate this entry. In order to avoid confusion it is best to not having ratings and reviews on at the same time. DESCRIPTION_ALLOW_COMMENTS=Whether to allow users to post comments about this entry. DESCRIPTION_SUBMITTER=The username of the member who controls this entry (usually the original submitter). ‘Guest’ implies that nobody controls the entry. DESCRIPTION_ORDER=The order priority this entry has in the category. DESCRIPTION_FIELD_ORDER=The order in which this field's name and corresponding value are placed when an entry is viewed. DESCRIPTION_FIELD_ORDER_CLEVER=The order in which this field's name and corresponding value are placed when an entry is viewed. If you change this order, the other field's orders will automatically rearrange so that their relative order remain unchanged, but so that there are no gaps in the ordering sequence. It's easiest to start ordering from 1 and then upwards. SUBMIT_UNVALIDATED=Entries are pre-moderated. Your entry has been flagged for validation, and a notification has been dispatched to the site staff. UNVALIDATED_TEXT=This entry has not yet been validated by our staff, so we cannot accept responsibility for it. You followed a direct link to get to it. UNVALIDATED_TEXT_STAFF=This entry has not yet been validated, but you have the following menus linking to it: {1}. UNVALIDATED_TEXT_NON_DIRECT=This entry has not yet been validated, but the staff have been notified to check it. DESCRIPTION_REPRESENTATIVE_IMAGE=A small image representing this category. IS_MEMBER_SYNCHED=Personal category container DESCRIPTION_IS_MEMBER_SYNCHED=Owned child categories (personal categories) will be automatically created as members submit – one per member. The child categories will automatically take on submission and permission settings of this. The child categories may only be submitted to by the owner of the child category, unless the “Submit to categories belonging to other members” permission is assigned. <strong>Regardless of permissions or settings, nobody will be able to submit to this category directly if you choose this option.</strong> NO_DELETE_ROOT=You cannot delete the root category EXPAND_TREE_LIST=Activate button to expand and categories under the following category CONTRACT_TREE_LIST=Activate button to contract the following category DESCRIPTION_CATEGORY=The category to place this within. DESCRIPTION_PARENT=The parent category (i.e. the category above this one). DESCRIPTION_VALIDATED=Set to 'ON' if you're ready for this be linked into the site (caveat: this setting will only be respected if you have the necessary privilege in the relevant category/content-type). DESCRIPTION_DELETE_LOSE_CONTENTS=Tick (check) this if this is to be deleted. This is immediate and irreversible. The contents of this category will also be deleted. DESCRIPTION_DELETE_ROOT_CONTENTS=Tick (check) this if this is to be deleted. This is immediate and irreversible. The contents of this category will be moved to the root category. DESCRIPTION_CATEGORY_TREE=The position in the category tree in which this belongs. TREE_LIST_HELP=Choose your selection by clicking the label (you will see it get highlighted).{1} If there are additional categories available underneath a category then there will be a clickable ‘plus’ icon shown to the left of it.{2} OWN_PARENT_ERROR=You cannot make a category its own ancestor. CAT_NOT_FOUND=A category (<kbd>{1}</kbd>) that doesn't exist is being referenced RECURSIVE_TREE_CHAIN=A recursive tree chain was found for category, {1}. NO_DELETE_LAST_CATEGORY=You cannot delete the only remaining category – there must always be at least one. You may, however, edit this category to make it meet your needs. |
