MITS Language Files Define Fixer voor modified eCommerce Shopsoftware

Met de MITS Language Files Define Fixer krijg je een krachtig hulpmiddel om taalbestanden van je modified eCommerce Shopsoftware blijvend netjes, stabiel en onderhoudsvriendelijk te houden.

Juist in individueel aangepaste shops of bij het gebruik van veel modules doet zich vaak een bekend probleem voor: taalconstanten worden meerdere keren gedefinieerd. Dat leidt tot onnodige PHP-notices en -warnings – zowel in de frontend als in de backend en vooral in de logbestanden.

Het probleem met meervoudig gedefinieerde taalconstanten

Modified eCommerce staat het gebruik van eigen taalbestanden toe en stimuleert dit zelfs, bijvoorbeeld via het mechanisme auto_include(). Eigen bestanden worden daarbij vaak opgeslagen in mappen zoals lang/german/extra/ of lang/english/extra/.

In de praktijk betekent dat echter:

• Standaardtaalbestanden definiëren al veel constanten
• Modules leveren eigen taalbestanden mee
• Eigen aanpassingen definiëren dezelfde constanten opnieuw

PHP reageert daarop met meldingen zoals:

Warning: Constant XYZ already defined

Deze meldingen veroorzaken vooral veel onnodige vermeldingen in de logbestanden – een echt probleem bij drukbezochte shops of shops die al lang draaien.

De oplossing: veilige verkorte define()-notatie

De MITS Language Files Define Fixer pakt precies dit aan. De module doorzoekt alle taalbestanden in de taalmap recursief en zet klassieke define()-instructies automatisch om in de veilige verkorte notatie:

defined('KONSTANTE') || define('KONSTANTE', 'Text');

Daardoor wordt een taalconstante alleen gedefinieerd als deze nog niet bestaat. Dubbele definities worden daarmee betrouwbaar uitgesloten.

Nieuw: taalmappen vergelijken en ontbrekende vertalingen aanvullen

Naast de klassieke defined()-correctie ondersteunt de module nu ook het vergelijken en aanvullen van taalbestanden in alle aanwezige taalmappen. Juist bij shops met veel talen gebeurt het snel dat afzonderlijke talen onvolledig worden na updates, module-installaties of eigen aanpassingen: bestanden ontbreken volledig of bepaalde taalconstanten komen alleen voor in german of english.

De module kan daarom alle taalmappen behalve german en english automatisch controleren en vergelijken met een instelbare referentietaal:

• Referentietaal: german of english (instelbaar)
• Elk taalbestand vergelijken met het overeenkomstige bestand van de referentietaal
• Ontbrekende taalconstanten herkennen
• Gestructureerde resultaatweergave met: taal, bestand, ontbrekende constanten

Optioneel: ontbrekende constanten automatisch aanvullen

Desgewenst kan de module gevonden hiaten niet alleen melden, maar direct verhelpen: ontbrekende constanten worden uit de referentietaal overgenomen en daarbij altijd veilig aangemaakt – zonder bestaande inhoud te overschrijven.

defined('CONSTANT_NAME') || define('CONSTANT_NAME', 'Wert');

• Ontbrekende items worden aangevuld
• Bestaande constanten blijven ongewijzigd
• Bestaande bestanden blijven ongewijzigd

Optioneel: volledig ontbrekende taalbestanden automatisch aanmaken

Als een taalbestand in een doeltaal volledig ontbreekt, kan de module dit eveneens automatisch afhandelen: het volledige bestand wordt uit de referentietaal overgenomen en vervolgens wordt de defined()-guardcorrectie automatisch toegepast. Dit gedrag is optioneel en kan naar behoefte worden in- of uitgeschakeld.

Correcte verwerking van taalafhankelijke bestandsnamen

In veel taalmappen bestaan taalafhankelijke hoofdbestanden die de naam van de betreffende taal dragen, bijvoorbeeld:

• lang/german/german.php
• lang/german/admin/german.php

Juist hier ontstaan bij handmatig onderhoud of eenvoudige kopieerscripts vaak fouten: bestanden met onjuiste namen worden naar andere taalmappen gekopieerd (bijv. german.php naar lang/french/). De MITS Language Files Define Fixer houdt correct rekening met deze bijzonderheid:

• Als bijvoorbeeld lang/french/french.php ontbreekt, wordt de inhoud uit lang/german/german.php (of english.php) overgenomen
• Het doelbestand wordt correct als french.php aangemaakt
• Hetzelfde geldt voor admin/french.php enz.

Daarmee wordt betrouwbaar voorkomen dat bestanden met onjuiste namen in andere taalmappen terechtkomen.

Resultatenoverzicht / dry-run

De module kan naar keuze:

• Alleen een overzicht van de gevonden problemen geven (dry-run)
• Of automatisch correcties uitvoeren

De resultatenlijst bevat onder andere:

• Ontbrekende bestanden
• Nieuw aangemaakte bestanden
• Aangevulde taalconstanten

Jouw voordelen in één oogopslag

• Voorkomt dubbele definities van taalconstanten
• Vermindert PHP-notices en -warnings blijvend
• Voorkomt onnodige logspam
• Vult ontbrekende taalconstanten automatisch aan (optioneel)
• Herkent en kopieert ontbrekende taalbestanden (optioneel)
• Correcte verwerking van taalspecifieke bestandsnamen
• Zorgt voor nette en volledige taalmappen
• Ideaal voor shops met veel modules en auto_include()
• Eenmalige uitvoering, geen voortdurende systeembelasting

Praktijkvoorbeeld uit het dagelijkse werk

Je beheert een modified-shop met meerdere uitbreidingen en eigen taalbestanden. Na updates of module-installaties nemen waarschuwingen in de logbestanden plotseling toe, terwijl de shop zichtbaar nog werkt.

Met de MITS Language Files Define Fixer kun je de hele taalmap met één klik controleren en aanpassen. Alle betreffende bestanden worden automatisch beveiligd – correct, snel en inzichtelijk.

Daarnaast zorgt de taalvergelijking ervoor dat ook andere talen volledig blijven: ontbrekende constanten en zelfs volledig ontbrekende bestanden worden herkend en – indien gewenst – automatisch aangevuld zonder bestaande vertalingen te overschrijven.

Juist bij veelvuldige updates of individuele aanpassingen bespaar je zo veel tijd en vermijd je op de lange termijn onnodige foutbronnen.

Belangrijke opmerking

De module brengt rechtstreeks wijzigingen aan in taalbestanden. Maak daarom vóór de uitvoering beslist een back-up van je taalmap.

Het gebruik van de module is op eigen risico. Een handmatige controle van afzonderlijke bestanden is doorgaans niet nodig, maar is altijd mogelijk en aanbevolen.

Conclusie

De MITS Language Files Define Fixer is een onmisbaar hulpmiddel als je met eigen taalbestanden werkt of veel modules gebruikt. Hij zorgt voor orde, stabiliteit en schone logbestanden – zonder in te grijpen in de kern.

Nieuw zijn de uitgebreide functies voor het controleren van taalmappen en het vergelijken met een referentietaal en voor het optioneel automatisch aanvullen van ontbrekende constanten en bestanden – inclusief correcte verwerking van taalafhankelijke bestandsnamen.

Nog een volledig gratis module van MerZ IT-SerVice, ontwikkeld vanuit de praktijk voor de praktijk.