Contao Community Documentation - Benutzerbeiträge [de]

Transifex mit Contao Toolbox

2014-12-17T01:10:42Z

BugBuster: /* Ursprungssprache hochladen zu Transifex */

[[Category:Transifex]]
[[Category:Dev_HOWTOS]]
[[Category:Development]]
[[Category:Extensions]]
<< [[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]
=Was ist das?=
Die Contao-Toolbox, kurz '''ctb''', gibt es auf GitHub: [https://github.com/cyberspectrum/contao-toolbox contao-toolbox] 
Das Konzept dahinter ist folgender.
* der Entwickler legt wie bisher PHP Sprachdateien an für die Ursprungsprache, z.B. "en", im Modul Unterverzeichnis language/en/
* mit ''ctb'' werden alle Sprachdateien in das XLIFF Format gewandelt
* anschließend werden die XLIFF Dateien der Ursprungsprache (default: en) mit ''ctb'' hoch geladen nach Transifex und tauchen dadurch in der Ursprungsprache als Ressourcen auf
* übersetzte Ressourcen anderer Sprachen werden mit ''ctb'' runter geladen im XLIFF Format
* anschließend werden mit ''ctb'' diese in PHP Sprachdateien umgewandelt und in das passende Verzeichnis abgelegt, z.B. language/de/

=Installation=
Die Installationanleitung entspricht der aus der Readme von ctb und kann auf zwei Arten erfolgen.
==Über composer==
Download composer wenn noch nicht vorhanden:
<source lang="bash">
curl -sS https://getcomposer.org/installer | php
</source>
Und nun die Contao Toolbox installieren:
<source lang="bash">
php composer create-project --prefer-source cyberspectrum/contao-toolbox
</source>
{{Achtung|Am Ende der Installation wird gefragt, ob die VCS History gelöscht werden kann, hier mit 'n' dieses verneinen. Sonst arbeitet der Compiler nicht richtig (folgt später)}}
<source lang="bash">
Do you want to remove the existing VCS (.git, .svn..) history? [Y,n]? n
</source>

==Über Git Cloning==
<source lang="bash">
git clone https://github.com/discordier/contao-toolbox.git
</source>
Anschließend als erstes die Abhängigkeiten auflösen.
<source lang="bash">
php composer update
</source>
Um nun die ctb von überall aufrufen zu können, diese liegt ja nicht im Suchpfad, habe ich dazu noch ein Alias angelegt. Pfad in diesem Beispiel muss jeder für sich anpassen:
<source lang="bash">
alias ctb='/contao_entwicklung/contao-toolbox/bin/ctb'
</source>
===Optional: eine ctb.phar kompilieren===
Zum kompilieren ruft man das mitgelieferten Compiler-Script auf.
<source lang="bash">
./bin/compile-ctb
</source>
Diese phar Datei kann man nun in ein Pfad kopieren auf dem ein Suchpfad liegt. Dadurch ist die spätere Nutzung einfacher. Dazu noch ein symbolischen Link anlegen, um ''ctb'' ohne die Endung .phar aufrufen zu können.
<source lang="bash">
ln -s ctb.phar ctb
</source>
Falls es zu einem Compiler Fehler kommt liegt es wohl an einer Einstellungen in der php.ini, dort muss definiert sein:
<source lang="ini">
[Phar]
phar.readonly = Off
</source>
Weitere Hinweise dazu: [http://php.net/phar.readonly php.net/phar.readonly] 

Wo die php.ini der PHP Kommandozeilenversion liegt, erfährt man so:
<source lang="bash">
php --ini | grep 'Configuration File'
</source>

=Konfiguration=
Um bei der Nutzung nicht immer Login und Passwort angeben zu müssen, kann man diese in seine Home-Verzeichnis in einer Konfigurationsdatei im json-Format anlegen wie folgt: <pre>`$HOME/.config/ctb/config.json`</pre>
<source lang="xml">
{
"transifex": {
"user": "john-doe",
"pass": "sUp3rPassword!"
}
}
</source>
In der composer.json der jeweiligen Erweiterung kann man ebenfalls einige Daten ablegen, um die Aufrufe auf Kommandozeile zu verkürzen.
Dazu den Abschnitt "extra" ergänzen:
<source lang="xml">
{
"extra":{
"contao": {
"transifex": {
"project": "acme-core",
"prefix": "core-",
"languages_cto": "languages",
"languages_tx": ".tx"
}
}
}
}
</source>
Dabei bedeuten:
* "project" : der Projektname auf Transifex
* "prefix" : ein frei wählbarer Prefix, aus diesem und dem originalem Dateiname wird der Dateiname für die Ressource generiert (z.B.: core-tl_module)
* "languages_cto": Verzeichnisname in dem die Sprachunterverzeichnisse liegen (/de/..., /en/... )
* "languages_tx": Verzeichnisname in der die umgewandelten XLIFF Datein abgelegt werden sollen

Mit dem "prefix" wäre es z.B. möglich, die Sprachdateien von mehreren Teilprojekten innerhalb eines einzigen transifex Projektes zu speichern.

=Kommandozeilen Workflow=
Im Hauptverzeichnis seiner Erweiterung ruft man nun die einzelnen Jobs auf die zu erledigen sind. Dabei wird von den obigen Definitionen ausgegangen.
Das ''--verbose'' dient hier nur zu Kontrolle, was gerade durchgeführt wird. Die ''--base-language'' könnte weggelassen werden, "en" ist hier das default.

==Sprachfiles in xliff umwandeln in Verzeichnis .tx==
<source lang="bash">
ctb to-xliff --base-language="en" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb to-xliff --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --verbose
</source>

==Ursprungssprache hochladen zu Transifex==
<source lang="bash">
ctb upload-transifex --base-language="en" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb upload-transifex --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --verbose
</source>

==Übersetzen in Transifex==
Zu diesem Zeitpunkt würde nun die Online-Übersetzung auf Transifex erfolgen. Liegen bereits weitere Sprachen vor, z.B. aus ER2 Zeiten, können diese manuell hochgeladen werden, dazu später. ('''ctb''' kann dieses derzeit nicht)

==Übersetze Sprachen von Transifex laden==
<source lang="bash">
ctb download-transifex --base-language="en" --mode="translated" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb download-transifex --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --mode="translated" --verbose
</source>
Hier wurde der default Wert vom Modus "reviewed" auf "translated" geändert. Damit bekommt man alle übersetzte Sprachen, egal wieviel Prozent davon fertig sind.

==Sprachfiles in PHP umwandeln und in die Sprachverzeichnisse ablegen==
<source lang="bash">
ctb from-xliff --base-language="en" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb from-xliff --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --verbose
</source>
Dabei werden die vorhandenen nur überschrieben, wenn Änderungen vorliegen.

=Upload weiterer Sprachen=

TODO: Wird ergänzt.

<< [[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]

Transifex mit Contao Toolbox

2014-12-17T01:09:31Z

BugBuster: /* Konfiguration */

[[Category:Transifex]]
[[Category:Dev_HOWTOS]]
[[Category:Development]]
[[Category:Extensions]]
<< [[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]
=Was ist das?=
Die Contao-Toolbox, kurz '''ctb''', gibt es auf GitHub: [https://github.com/cyberspectrum/contao-toolbox contao-toolbox] 
Das Konzept dahinter ist folgender.
* der Entwickler legt wie bisher PHP Sprachdateien an für die Ursprungsprache, z.B. "en", im Modul Unterverzeichnis language/en/
* mit ''ctb'' werden alle Sprachdateien in das XLIFF Format gewandelt
* anschließend werden die XLIFF Dateien der Ursprungsprache (default: en) mit ''ctb'' hoch geladen nach Transifex und tauchen dadurch in der Ursprungsprache als Ressourcen auf
* übersetzte Ressourcen anderer Sprachen werden mit ''ctb'' runter geladen im XLIFF Format
* anschließend werden mit ''ctb'' diese in PHP Sprachdateien umgewandelt und in das passende Verzeichnis abgelegt, z.B. language/de/

=Installation=
Die Installationanleitung entspricht der aus der Readme von ctb und kann auf zwei Arten erfolgen.
==Über composer==
Download composer wenn noch nicht vorhanden:
<source lang="bash">
curl -sS https://getcomposer.org/installer | php
</source>
Und nun die Contao Toolbox installieren:
<source lang="bash">
php composer create-project --prefer-source cyberspectrum/contao-toolbox
</source>
{{Achtung|Am Ende der Installation wird gefragt, ob die VCS History gelöscht werden kann, hier mit 'n' dieses verneinen. Sonst arbeitet der Compiler nicht richtig (folgt später)}}
<source lang="bash">
Do you want to remove the existing VCS (.git, .svn..) history? [Y,n]? n
</source>

==Über Git Cloning==
<source lang="bash">
git clone https://github.com/discordier/contao-toolbox.git
</source>
Anschließend als erstes die Abhängigkeiten auflösen.
<source lang="bash">
php composer update
</source>
Um nun die ctb von überall aufrufen zu können, diese liegt ja nicht im Suchpfad, habe ich dazu noch ein Alias angelegt. Pfad in diesem Beispiel muss jeder für sich anpassen:
<source lang="bash">
alias ctb='/contao_entwicklung/contao-toolbox/bin/ctb'
</source>
===Optional: eine ctb.phar kompilieren===
Zum kompilieren ruft man das mitgelieferten Compiler-Script auf.
<source lang="bash">
./bin/compile-ctb
</source>
Diese phar Datei kann man nun in ein Pfad kopieren auf dem ein Suchpfad liegt. Dadurch ist die spätere Nutzung einfacher. Dazu noch ein symbolischen Link anlegen, um ''ctb'' ohne die Endung .phar aufrufen zu können.
<source lang="bash">
ln -s ctb.phar ctb
</source>
Falls es zu einem Compiler Fehler kommt liegt es wohl an einer Einstellungen in der php.ini, dort muss definiert sein:
<source lang="ini">
[Phar]
phar.readonly = Off
</source>
Weitere Hinweise dazu: [http://php.net/phar.readonly php.net/phar.readonly] 

Wo die php.ini der PHP Kommandozeilenversion liegt, erfährt man so:
<source lang="bash">
php --ini | grep 'Configuration File'
</source>

=Konfiguration=
Um bei der Nutzung nicht immer Login und Passwort angeben zu müssen, kann man diese in seine Home-Verzeichnis in einer Konfigurationsdatei im json-Format anlegen wie folgt: <pre>`$HOME/.config/ctb/config.json`</pre>
<source lang="xml">
{
"transifex": {
"user": "john-doe",
"pass": "sUp3rPassword!"
}
}
</source>
In der composer.json der jeweiligen Erweiterung kann man ebenfalls einige Daten ablegen, um die Aufrufe auf Kommandozeile zu verkürzen.
Dazu den Abschnitt "extra" ergänzen:
<source lang="xml">
{
"extra":{
"contao": {
"transifex": {
"project": "acme-core",
"prefix": "core-",
"languages_cto": "languages",
"languages_tx": ".tx"
}
}
}
}
</source>
Dabei bedeuten:
* "project" : der Projektname auf Transifex
* "prefix" : ein frei wählbarer Prefix, aus diesem und dem originalem Dateiname wird der Dateiname für die Ressource generiert (z.B.: core-tl_module)
* "languages_cto": Verzeichnisname in dem die Sprachunterverzeichnisse liegen (/de/..., /en/... )
* "languages_tx": Verzeichnisname in der die umgewandelten XLIFF Datein abgelegt werden sollen

Mit dem "prefix" wäre es z.B. möglich, die Sprachdateien von mehreren Teilprojekten innerhalb eines einzigen transifex Projektes zu speichern.

=Kommandozeilen Workflow=
Im Hauptverzeichnis seiner Erweiterung ruft man nun die einzelnen Jobs auf die zu erledigen sind. Dabei wird von den obigen Definitionen ausgegangen.
Das ''--verbose'' dient hier nur zu Kontrolle, was gerade durchgeführt wird. Die ''--base-language'' könnte weggelassen werden, "en" ist hier das default.

==Sprachfiles in xliff umwandeln in Verzeichnis .tx==
<source lang="bash">
ctb to-xliff --base-language="en" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb to-xliff --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --verbose
</source>

==Urpsungssprache hochladen zu Transifex==
<source lang="bash">
ctb upload-transifex --base-language="en" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb upload-transifex --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --verbose
</source>

==Übersetzen in Transifex==
Zu diesem Zeitpunkt würde nun die Online-Übersetzung auf Transifex erfolgen. Liegen bereits weitere Sprachen vor, z.B. aus ER2 Zeiten, können diese manuell hochgeladen werden, dazu später. ('''ctb''' kann dieses derzeit nicht)

==Übersetze Sprachen von Transifex laden==
<source lang="bash">
ctb download-transifex --base-language="en" --mode="translated" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb download-transifex --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --mode="translated" --verbose
</source>
Hier wurde der default Wert vom Modus "reviewed" auf "translated" geändert. Damit bekommt man alle übersetzte Sprachen, egal wieviel Prozent davon fertig sind.

==Sprachfiles in PHP umwandeln und in die Sprachverzeichnisse ablegen==
<source lang="bash">
ctb from-xliff --base-language="en" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb from-xliff --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --verbose
</source>
Dabei werden die vorhandenen nur überschrieben, wenn Änderungen vorliegen.

=Upload weiterer Sprachen=

TODO: Wird ergänzt.

<< [[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]

Cron

2014-12-14T23:17:25Z

BugBuster: /* Beispiel Script */

Automatisierung von Batch Programmen mittels Zeitsteuerung
* Automatische zeitgesteuerte Ausführung von PHP Skripten.
* Zeitsteuerungs-Syntax von UNIX cron/crontab.
* Benötigt kein “richtiges” cron, wird bei Backend Seitenaufrufen ausgeführt
* Frontend Auslösung mittels Frontend Modul möglich
* Alternative Auslösung mittels “echtem” cron möglich.
{{ExtInfo
| Dev=Glen Langer ([[User:BugBuster|BugBuster]])
| DevSite=http://www.contao.glen-langer.de
| ExtVersion=3.1.0
| Version=ab 3.0
| TLVersion=2.7.0 - 2.9.5 (siehe Installationshinweise)
| ERLink=https://contao.org/de/extension-list/view/cron.de.html
| DonateLink=http://www.amazon.de/wishlist/26HHEJOU03G76
| TrackerLink=https://github.com/BugBuster1701/contao-cron/issues
| VCSLink=https://github.com/BugBuster1701/contao-cron
| Comment=Version für Contao 3.1 verfügbar
}}
[[Kategorie:Extensions]]

=Vorwort=
Die Erweiterung Cron stammt ursprünglich von Peter Koch (acenes) und wurde von mir übernommen mit dem Ziel, diese für Contao 3 kompatibel zu machen. Die Beschreibung hier bezieht sich nur auf die Cron Version ab 3.0.0 für Contao 3.

=Forum=
Fragen zur Cron Erweiterung werden im Forum beantwortet: [https://community.contao.org/de/forumdisplay.php?119 Forum - Sonstige-Erweiterungen]
 
Fehler und Wünsche können im [https://github.com/BugBuster1701/contao-cron/issues Tracking System] gemeldet werden.

=Installation=
Installation erfolgt über das Extension Repository im Backend der Contao Installation. 
Eine manuelle Installation ist möglich, dazu die ZIP Datei [https://contao.org/de/extension-list/view/cron.de.html vom Extension Repository laden], entpacken und entsprechend übertragen. 
Danach wie dabei üblich /contao/install.php aufrufen um ein eventuelles Update der Datenbank durchführen. 
 
==Hinweis für ältere TYPOlight Versionen==
Nutzer von TYPOlight 2.9/2.8/2.7 nutzen bitte Cron Version 1.1.0 ([http://www.contao.org/erweiterungsliste/view/cron.10010009.de.html Direktlink])
 

=Installation als Update=
Ein Update erfolgt identisch der Installation. 
{{Achtung|Beim Update von Contao 2 auf Contao 3 muss die Erweiterung vollständig deinstalliert/gelöscht werden, da Contao 3 intern die Tabelle tl_cron nutzt, die bisher die Erweiterung Cron nutzte.}}
'''Für die Profis''': Deinstallation ohne Löschung der Tabelle tl_cron, diese umbenennen nach tl_crontab, dann Update nach Contao 3 und die neue Version von Cron für Contao 3 installieren. So sollten die eingerichteten Cron-Jobs erhalten bleiben. Job Pfade müssen aber geprüft werden, falls der Demo Job genutzt wurde.

=Auslösen des Schedulers=
==Backend==
Standardmäßig wird der Scheduler bei jeder Backend Seitenaktualisierung ausgelöst.
==Frontend==
Über ein Frontend Modul (ab Cron 3.1.0), welches aber keine Ausgabe erzeugt und somit das Layout nicht stört, ist die Auslösung auch über Seitenaufrufe des Frontends möglich. Bei Jobs die längere Zeit benötigen ist diese Art der Auslösung ungeeignet.
In einer der nächsten Versionen wird es dazu eine Verbesserung geben, entweder auf die Art und Weise wie der Contao interne Frontend-Cron funktioniert oder als Job für diesen. Evaluierung erfolgt demnächst dazu.

==Luxus Lösung mit realem Cron==
Hat man einen Server zur Verfügung in dem Cron-Jobs eingerichtet werden können, kann man diesen System Cron nutzen um die Cron Erweiterung darüber auszulösen.
Der Vorteil ist, dass der Cron-Job genau zur geplanten Zeit gestartet wird, auch wenn niemand auf die Website zugreift. Auch bei Seiten mit sehr hohem Traffic, wird diese Art der Auslösung die Webserver Last etwas senken. (im Vergleich zur FE-Modul Auslösung)

Folgende Zeile in die crontab eintragen, vorher anpassen mit der eigenen Domain natürlich.
<source lang="bash">
* * * * * wget -t 1 -O - http://www.example.com/system/modules/cron/public/CronController.php >/dev/null 2>&1
</source>

=Cron-Jobs definieren=
Über Backend - System - Scheduler sieht man zunächst die Übersicht bereits eingerichteter Cron-Jobs. Als Beispiel hier ein Job zum löschen der Music Academy Demo Dateien und der mitgelieferte Demo Job zum löschen der Einträge im System-Log.
[[Datei:Scheduler_overview_de.png]]

Der Job zum löschen der System-Log Einträge im Detail:
[[Datei:Scheduler_purge_system_log_de.png]]

=Benutzerdefinierte Cron-Job Scripte=
Die Erweiterung bringt ein Beispielskript "PurgeLog.php" mit im Unterverzeichnis "jobs". Hier kann man schon einiges erkennen wie es läuft. Weiter unten folgt ein weiteres kleines Beispiel.

==Allgemeine Überlegungen==
Generell sollte man versuchen, kleine Jobs wann immer möglich zu schaffen, die nicht lange laufen. Zum Beispiel statt der Schaffung eines großen Jobs, das 3 Dinge tut, ist es besser, 3 kleinere Jobs zu schaffen. Auf diese Weise kann die Last in 3 verschiedenen Seitenaufrufe vom Scheduler verteilt werden. 
Die Laufzeit eines Jobs sollte kurz bleiben, weil der Benutzer eine Sanduhr so lange zu sehen bekommt bis dieser fertig ist. Wenn es zu lange dauert wird man denken, es gibt ein Problem mit der Website oder mit dem Computer und bricht die Anfrage ab oder schließt gar den Browser.

==Das globale Array $cronJob==
Es gibt eine globales Array $cronjob die einem hilft den Job in sinnvolle Stücke aufzuteilen, und einige Informationen und Kontrolle bietet:

===$cronJob['id']===

ID in der Job Table tl_crontab. 
Dieser Parameter kann nur gelesen werden, eine Änderung hat keine Auswirkung.

===$cronJob['title']===

Titel des Jobs. 
Dieser Parameter kann nur gelesen werden, eine Änderung hat keine Auswirkung.

===$cronJob['lastrun']===

Zeitstempel der letzten Ausführung. Der Wert ist 0 wenn unbekannt bzw. noch nie ein Start erfolgte. 
Dieser Parameter kann nur gelesen werden, eine Änderung hat keine Auswirkung.

===$cronJob['endtime']===

Ab dieser Zeit sollt der Job stoppen, z.B. in dem keine neuen Aktionen mehr ausgeführt werden. 
Dieser Parameter kann nur gelesen werden, eine Änderung hat keine Auswirkung.

===$cronJob['runonce']===

"true": der Job wird nach komplettem Durchlauf deaktiviert. 
Das kann im Job selbst geändert werden: 
* Setzen auf "true" : der Job wird nach komplettem Durchlauf deaktiviert..
* Setzen auf "false": der Job wird nach komplettem Durchlauf nicht deaktiviert.
Setzt man $cronJob['completed'] auf "false", wird der Job nicht deaktiviert auch wenn $cronJob['runonce'] auf "true" gesetzt ist.

===$cronJob['logging']===

"true": die Protokollierung des Jobs ist eingeschaltet, für Testzwecke gedacht. 
"false": nur Fehler werden protokolliert, so sollte der Job im Normalfall eingestellt sein. 
Dieser Wert kann vom Job geändert werden, führt aber eventuell zur Verwirrung der Nutzer:
* Setzen auf "true" : die Protokollierung des Jobs ist eingeschaltet.
* Setzen auf "false": die Protokollierung des Jobs ist abgeschaltet, bis auf Fehlermeldungen.

===$cronJob['completed']===

Dieser Status ist per Default "true" und bedeutet, wenn der Job fertig ist wird dieser als erledigt markiert und wird neu geplant.
 
Benötigt der Job zu viel Zeit und man hat die Möglichkeit diesen abzubrechen und beim nächsten Aufruf an der Stelle weiter zu machen, setzt man diesen Status auf "false" und beendet den Job. Dadurch wird der alte Zeitplan beibehalten und beim nächsten Scheduler Aufruf der Job wieder gestartet, um die Arbeit abzuschließen.

==Beispiel Script==
Script liegt hier unter system/modules/cron/jobs/PurgeLog.php

<source lang="php">
<?php

/**
* Initialize the system
*/
if (!function_exists('log_message')) // zur Vermeidung von PHP Fatal error: Cannot redeclare __error()
{
define('TL_MODE', 'BE');

// Suche nach initialize.php, damit auch über composer nutzbar
$dir = __DIR__;

while ($dir != '.' && $dir != '/' && !is_file($dir . '/system/initialize.php'))
{
$dir = dirname($dir);
}

if (!is_file($dir . '/system/initialize.php'))
{
echo 'Could not find initialize.php!';
exit(1);
}
require($dir . '/system/initialize.php');
}

/**
* Class PurgeLog
*
* @copyright Glen Langer 2012..2013 <http://www.contao.glen-langer.de>
* @author Glen Langer (BugBuster)
* @package Cron
*/
class PurgeLog extends Backend
{

/**
* Initialize the controller
*/
public function __construct()
{
parent::__construct();
} // __construct

/**
* Implement the commands to run by this batch program
*/
public function run()
{
global $cronJob; // from CronController

//At this time the job should be defered,
//no new actions should be started after this time.
if (time() >= $cronJob['endtime'])
{
$cronJob['completed'] = false;
return;
}

$this->Database->prepare("DELETE FROM `tl_log`")->executeUncached();
if ($cronJob['logging'])
{
$this->log('System log purged by cron job.', 'PurgeLog run()', TL_GENERAL);
}
} // run

} // class PurgeLog

/**
* Instantiate log purger
*/
$objPurge = new PurgeLog();
$objPurge->run();
</source>

==Weitere Cron-Jobs==
Weitere Cron-Jobs werden in einem extra Wiki Artikel gezeigt: [[Cron-Jobs_für_Erweiterung_Cron]]

----
--[[Benutzer:BugBuster|BugBuster]] 15:45, 2. Jun. 2013 (CEST)

Composer/Hosting

2014-08-28T12:58:08Z

BugBuster: /* Tipps und Tricks */

{{stub}}
[[Category:Composer]]
[[Category:Extensions]]
[[Category:Admin HOWTOS]]
[[Category:Installation und Updates]]

=Kompatibilitätsliste=

Auf dieser Seite werden Webhoster gelistet, auf denen Contao mit Composer läuft, mit Einschränkungen läuft oder nicht läuft.

==Kompatible Webhostingpakete==

Bitte beim Eintragen auf eine alfabetische Reihenfolge achten.

* [https://www.all-inkl.com/ All-Inkl] Getestet unter Contao 3.3.5 auf Paket 'all-inkl PrivatPlus', mit Zeile ''AddHandler php53-cgi .php'' am Anfang der .htaccess ([[User:Nina|Nina]])
* [https://www.df.eu/ domainfactory] ManagedServer L4 ([[User:Hellschu|Hellschu]])/ ab ManagedHosting Pro lauffähig ([[User:MacKP|MacKP]])
* [http://hosteurope.de/ Hosteurope] Virtual Server Managed, phar whitellisten ([[User:Lucina|Lucina]])
* [https://inetrobots.de/ Inetrobots.de] Getestet mit Webhosting "Professional" ([https://community.contao.org/de/member.php?4042-ciaobello ciaobello]).
* [https://www.fc-hosting.de/ fc-hosting.de] Paket: Expert 3.2 ohne Extras ([https://community.contao.org/de/member.php?6680-dackelchen dackelchen])
* [http://www.metanet.ch Metanet.ch] Wichtig ist zu beachten dass mindestens Plesk 11.5 installiert ist (darauf beharren). Dann kann die notwendige Funktion im Kontrollpanel pro Domain eingeschaltet werden. Getestet mit METAHost ([https://community.contao.org/de/member.php?4042-ciaobello ciaobello]).
* [http://w4w.net/ w4w.net] Standardhosting ([[User:Lucina|Lucina]])
* [https://www.webhostone.de/ WebhostOne] Webhosting MultiApp ([[User:Lucina|Lucina]])

==Inkompatible Webhostingpakete==

* [http://df.eu/ Domain Factory] MyHomePlus (zu geringe Ressourcen, u.a. nur 50 MB Ram ([[User:Lucina|Lucina]])
* [https://www.hosteurope.de/ Hosteurope] Webpack (nicht Webpack Pro) (Ursache z.Zt. unbekannt) ([[User:Lucina|Lucina]])
* [https://www.webhostone.de/ WebhostOne] Webhosting Single App (RAM nicht ausreichend) ([[User:Lucina|Lucina]])
==Tipps und Tricks ==
* Bei df.eu kann die php.ini so bearbeitet werden, das auch die Optionalen Bedingungen erfüllt werden (per php.ini Editor im Backend von df.eu)
* Bei goneo + PHP 5.4 kann eine eigene php.ini verwendet werden, damit kann man die Bedingungen erreichen. [[Webhoster#goneo]]

Mediabox auf Deutsch

2014-08-20T16:30:57Z

BugBuster: /* Variante ab Contao 3.2 (HTML5) */

[[Kategorie:Mediabox]]
{{AppliesTo|TLVersion=ab 2.8.2}}
Oft besteht der Wunsch, die Mediabox einzudeutschen. Da die Buttons dabei schon auf neutrale Symbole geändert wurden, reicht es, nur den Text "x of y" zu ändern. 
Dazu erstellt man eine Kopie von moo_mediabox.tpl|xhtml|html5 (z.B. moo_mediabox_de.html5) direkt über das Backend:
* "Layout" - "Templates"
* Neues Template , Auswahl moo_mediabox, Template erstellen (hier je nach Ausgabeformat das richtige auswählen)
* Template umbenennen (Bleistift) nach moo_mediabox_de (die Endung fügt Contao selber an, also vorher das richtige Template auswählen)
* Template editieren, Code anpassen wie unten gezeigt, speichern

Nun muss man im Layout noch das geänderte Template aktivieren, dazu unter:
* "Layout" - "Themes" - "Seitenlayouts" - Layout bearbeiten (Contao ab 2.9)
* "Layout" - "Seitenlayouts" - Layout bearbeiten (TYPOlight bis 2.8.x)
* hier nimmt man nun bei "MooTools-Templates" das Häkchen bei "moo_mediabox" raus und bei "moo_mediabox_de" rein.
* fertig

==Variante ab Contao 3.2 (HTML5)==
<source lang="javascript">
<?php

// Add mediabox style sheet
$GLOBALS['TL_CSS'][] = 'assets/mootools/mediabox/'. MEDIABOX .'/css/mediaboxAdvBlack21.css|screen';

?>

<script src="<?php echo TL_ASSETS_URL; ?>assets/mootools/mediabox/<?php echo MEDIABOX; ?>/js/mediabox.js"></script>
<script>
(function($) {
window.addEvent('domready', function() {
var links = $$('a').filter(function(el) {
return el.getAttribute('data-lightbox') != null;
});
$$(links).mediabox({
// Put custom options here
counterText: ' (Bild {x} von {y})'
}, function(el) {
return [el.href, el.title, el.getAttribute('data-lightbox')];
}, function(el) {
var data = this.getAttribute('data-lightbox').split(' ');
return (this == el) || el.getAttribute('data-lightbox').match(data[0]);
});
// Support swiping on mobile devices
$('mbImage').addEvent('swipe', function(e) {
(e.direction == 'left') ? $('mbNextLink').fireEvent('click') : $('mbPrevLink').fireEvent('click');
});
});
})(document.id);
</script>
</source>
Die Zeile mit "counterText" wurde eingefügt.
 

==Variante ab Contao 2.11 (HTML5)==
<source lang="javascript">
<?php

// Add mediabox style sheet
$GLOBALS['TL_CSS'][] = TL_PLUGINS_URL . 'plugins/mediabox/'. MEDIABOX .'/css/mediaboxAdvBlack21.css|screen';

?>

<script src="<?php echo TL_PLUGINS_URL; ?>plugins/mediabox/<?php echo MEDIABOX; ?>/js/mediabox.js"></script>
<script>
Mediabox.scanPage = function() {
var links = $$('a').filter(function(el) {
return el.getAttribute('data-lightbox') != null;
});
$$(links).mediabox({
counterText: '(Bild {x} von {y})'
}, function(el) {
return [el.href, el.title, el.getAttribute('data-lightbox')];
}, function(el) {
var data = this.getAttribute('data-lightbox').split(' ');
return (this == el) || (data[0] && el.getAttribute('data-lightbox').match(data[0]));
});
};
window.addEvent('domready', Mediabox.scanPage);
</script>
</source>
Die Zeile mit "counterText" wurde eingefügt, der deutsche Text wurde noch in <nowiki></nowiki> Tags eingebunden.
 

==Variante ab Contao 2.10 (XHTML)==
<source lang="javascript">
<?php

// Add mediabox style sheet
$GLOBALS['TL_CSS'][] = TL_PLUGINS_URL . 'plugins/mediabox/'. MEDIABOX .'/css/mediaboxAdvBlack21.css|screen';

?>

<script type="text/javascript" src="<?php echo TL_PLUGINS_URL; ?>plugins/mediabox/<?php echo MEDIABOX; ?>/js/mediabox.js"></script>
<script type="text/javascript">
/* <![CDATA[ */
Mediabox.scanPage = function() {
var links = $$('a').filter(function(el) {
return el.rel && el.rel.test(/^lightbox/i);
});
$$(links).mediabox({counterText: '(Bild {x} von {y})'}, null, function(el) {
var rel0 = this.rel.replace(/[[]|]/gi,' ');
var relsize = rel0.split(' ');
return (this == el) || ((this.rel.length > 8) && el.rel.match(relsize[1]));
});
};
window.addEvent('domready', Mediabox.scanPage);
/* ]]> */
</script>
</source>
Der deutsche Text wurde noch in <nowiki></nowiki> Tags eingebunden.
 

==Variante ab Contao 2.9.1==
<source lang="javascript">
<?php

// Add mediabox style sheet
$GLOBALS['TL_CSS'][] = 'plugins/mediabox/css/mediabox.css?'. MEDIABOX .'|screen';

?>

<script type="text/javascript" src="plugins/mediabox/js/mediabox.js?<?php echo MEDIABOX; ?>"></script>
<script type="text/javascript">
<![CDATA[//><!]]>
</script>
</source>
Der deutsche Text wurde noch in <nowiki></nowiki> Tags und einem <nowiki> </nowiki> eingebunden. Grund ist ein kleiner Bug in Mediabox, der dazu führen kann, dass der Beschreibungstext nicht vollständig angezeigt wird, da die Höhe dafür falsch berechnet wird. 
Die Tags zwingen nun die Mediabox dazu die Höhe zu erweitern. Dadurch entstehen zwar ab und zu darunter unschöne Abstände, aber der Text ist dafür vollständig, was wichtiger ist.
 
==Variante für Contao 2.8==
<source lang="javascript">
<?php

// Add mediabox style sheet
$GLOBALS['TL_CSS'][] = 'plugins/mediabox/css/mediabox.css|screen';

?>

<script type="text/javascript" src="plugins/mediabox/js/mediabox.js"></script>
<script type="text/javascript">
<![CDATA[//><!]]>
</script>
</source>
Der deutsche Text wurde noch in <nowiki></nowiki> Tags und einem <nowiki> </nowiki> eingebunden. Grund ist ein kleiner Bug in Mediabox, der dazu führen kann, dass der Beschreibungstext nicht vollständig angezeigt wird, da die Höhe dafür falsch berechnet wird. 
Die Tags zwingen nun die Mediabox dazu die Höhe zu erweitern. Dadurch entstehen zwar ab und zu darunter unschöne Abstände, aber der Text ist dafür vollständig, was wichtiger ist.
 

----
--[[Benutzer:BugBuster|BugBuster]] 23:11, 2. Jan. 2012 (CET)

Mediabox auf Deutsch

2014-08-20T16:29:28Z

BugBuster: /* Variante ab Contao 3.2 (HTML5) */

[[Kategorie:Mediabox]]
{{AppliesTo|TLVersion=ab 2.8.2}}
Oft besteht der Wunsch, die Mediabox einzudeutschen. Da die Buttons dabei schon auf neutrale Symbole geändert wurden, reicht es, nur den Text "x of y" zu ändern. 
Dazu erstellt man eine Kopie von moo_mediabox.tpl|xhtml|html5 (z.B. moo_mediabox_de.html5) direkt über das Backend:
* "Layout" - "Templates"
* Neues Template , Auswahl moo_mediabox, Template erstellen (hier je nach Ausgabeformat das richtige auswählen)
* Template umbenennen (Bleistift) nach moo_mediabox_de (die Endung fügt Contao selber an, also vorher das richtige Template auswählen)
* Template editieren, Code anpassen wie unten gezeigt, speichern

Nun muss man im Layout noch das geänderte Template aktivieren, dazu unter:
* "Layout" - "Themes" - "Seitenlayouts" - Layout bearbeiten (Contao ab 2.9)
* "Layout" - "Seitenlayouts" - Layout bearbeiten (TYPOlight bis 2.8.x)
* hier nimmt man nun bei "MooTools-Templates" das Häkchen bei "moo_mediabox" raus und bei "moo_mediabox_de" rein.
* fertig

==Variante ab Contao 3.2 (HTML5)==
<source lang="javascript">
<script src="<?php echo TL_ASSETS_URL; ?>assets/mootools/mediabox/<?php echo MEDIABOX; ?>/js/mediabox.js"></script>
<script>
(function($) {
window.addEvent('domready', function() {
var links = $$('a').filter(function(el) {
return el.getAttribute('data-lightbox') != null;
});
$$(links).mediabox({
// Put custom options here
counterText: ' (Bild {x} von {y})'
}, function(el) {
return [el.href, el.title, el.getAttribute('data-lightbox')];
}, function(el) {
var data = this.getAttribute('data-lightbox').split(' ');
return (this == el) || el.getAttribute('data-lightbox').match(data[0]);
});
// Support swiping on mobile devices
$('mbImage').addEvent('swipe', function(e) {
(e.direction == 'left') ? $('mbNextLink').fireEvent('click') : $('mbPrevLink').fireEvent('click');
});
});
})(document.id);
</script>
</source>
Die Zeile mit "counterText" wurde eingefügt.
 

==Variante ab Contao 2.11 (HTML5)==
<source lang="javascript">
<?php

// Add mediabox style sheet
$GLOBALS['TL_CSS'][] = TL_PLUGINS_URL . 'plugins/mediabox/'. MEDIABOX .'/css/mediaboxAdvBlack21.css|screen';

?>

<script src="<?php echo TL_PLUGINS_URL; ?>plugins/mediabox/<?php echo MEDIABOX; ?>/js/mediabox.js"></script>
<script>
Mediabox.scanPage = function() {
var links = $$('a').filter(function(el) {
return el.getAttribute('data-lightbox') != null;
});
$$(links).mediabox({
counterText: '(Bild {x} von {y})'
}, function(el) {
return [el.href, el.title, el.getAttribute('data-lightbox')];
}, function(el) {
var data = this.getAttribute('data-lightbox').split(' ');
return (this == el) || (data[0] && el.getAttribute('data-lightbox').match(data[0]));
});
};
window.addEvent('domready', Mediabox.scanPage);
</script>
</source>
Die Zeile mit "counterText" wurde eingefügt, der deutsche Text wurde noch in <nowiki></nowiki> Tags eingebunden.
 

==Variante ab Contao 2.10 (XHTML)==
<source lang="javascript">
<?php

// Add mediabox style sheet
$GLOBALS['TL_CSS'][] = TL_PLUGINS_URL . 'plugins/mediabox/'. MEDIABOX .'/css/mediaboxAdvBlack21.css|screen';

?>

<script type="text/javascript" src="<?php echo TL_PLUGINS_URL; ?>plugins/mediabox/<?php echo MEDIABOX; ?>/js/mediabox.js"></script>
<script type="text/javascript">
/* <![CDATA[ */
Mediabox.scanPage = function() {
var links = $$('a').filter(function(el) {
return el.rel && el.rel.test(/^lightbox/i);
});
$$(links).mediabox({counterText: '(Bild {x} von {y})'}, null, function(el) {
var rel0 = this.rel.replace(/[[]|]/gi,' ');
var relsize = rel0.split(' ');
return (this == el) || ((this.rel.length > 8) && el.rel.match(relsize[1]));
});
};
window.addEvent('domready', Mediabox.scanPage);
/* ]]> */
</script>
</source>
Der deutsche Text wurde noch in <nowiki></nowiki> Tags eingebunden.
 

==Variante ab Contao 2.9.1==
<source lang="javascript">
<?php

// Add mediabox style sheet
$GLOBALS['TL_CSS'][] = 'plugins/mediabox/css/mediabox.css?'. MEDIABOX .'|screen';

?>

<script type="text/javascript" src="plugins/mediabox/js/mediabox.js?<?php echo MEDIABOX; ?>"></script>
<script type="text/javascript">
<![CDATA[//><!]]>
</script>
</source>
Der deutsche Text wurde noch in <nowiki></nowiki> Tags und einem <nowiki> </nowiki> eingebunden. Grund ist ein kleiner Bug in Mediabox, der dazu führen kann, dass der Beschreibungstext nicht vollständig angezeigt wird, da die Höhe dafür falsch berechnet wird. 
Die Tags zwingen nun die Mediabox dazu die Höhe zu erweitern. Dadurch entstehen zwar ab und zu darunter unschöne Abstände, aber der Text ist dafür vollständig, was wichtiger ist.
 
==Variante für Contao 2.8==
<source lang="javascript">
<?php

// Add mediabox style sheet
$GLOBALS['TL_CSS'][] = 'plugins/mediabox/css/mediabox.css|screen';

?>

<script type="text/javascript" src="plugins/mediabox/js/mediabox.js"></script>
<script type="text/javascript">
<![CDATA[//><!]]>
</script>
</source>
Der deutsche Text wurde noch in <nowiki></nowiki> Tags und einem <nowiki> </nowiki> eingebunden. Grund ist ein kleiner Bug in Mediabox, der dazu führen kann, dass der Beschreibungstext nicht vollständig angezeigt wird, da die Höhe dafür falsch berechnet wird. 
Die Tags zwingen nun die Mediabox dazu die Höhe zu erweitern. Dadurch entstehen zwar ab und zu darunter unschöne Abstände, aber der Text ist dafür vollständig, was wichtiger ist.
 

----
--[[Benutzer:BugBuster|BugBuster]] 23:11, 2. Jan. 2012 (CET)

Webhoster

2014-08-18T21:05:20Z

BugBuster: /* Goneo */

[[Category:Installation und Updates]]
=Liste kompatibler Webhoster=
<big>'''Diese Informationen basieren ausschließlich auf Erfahrungen von Nutzern. Diese Erfahrungen stimmen teilweise nicht für alle Webpakete eines Anbieters! Manchmal ändern Anbieter auch die technischen Einstellungen, so dass sich neue Umstände ergeben. Verlasst euch niemals nur darauf, sondern führt wenn möglich mindestens eine Diagnose, am besten aber eine Testinstallation auf einem Test-Webspace (beim Anbieter nachfragen) durch.'''</big>

Abkürzungen:
* SMH = [[Safemode Hack]]
* ER = [[Systemdiagnosetool#PHP_configuration|Extension Repository]] (siehe ''SOAP extension'')
* LU = Live Update

{| border="0" cellpadding="5" cellspacing="1" style="vertical-align:top;"

|-
!Webhoster
!Tarif
!SMH notwendig
!.htaccess notwendig
!php.ini notwendig
!CHMOD notwendig
!ER möglich
!LU möglich
!Sonstige Anmerkungen
|-
| [http://www.1und1.de 1&1] || ab 1&1 Homepage Perfect || nein || {{td_red |PHP 5}} || nein || nein || ja || ja || [[1 und 1 Internet|detaillierte Installationsanleitung]]
|-
| [http://www.1blu.de 1blu] || Homepage Unlimited, Homepage Professional || nein || nein || nein || nein || ja || ja || [[#1blu|Details]]
|-
| [http://alfahosting.de Alfahosting] || Multipaket, Profipaket, Businesspaket || nein || nein || nein || nein || ja || ja || [[#Alfahosting|Details]]
|-
| [http://all-inkl.com All-Inkl] || ab "Start" Tarif || nein || {{td_red| PHP 5}} || nein || nein || ja || ja || [[#All-Inkl|Details]]
|-
| [http://www.arcor.de Arcor] || 700 MB Webspace || {{td_yellow |unbekannt}} || nein || nein || nein || {{td_red | SOAP}} || ja || [[#Arcor|Details]]
|-
| [http://www.bytecamp.net bytecamp] || bytecamp arbeitet mit einem einzigen Tarifmodell || nein || {{td_red |PHP 5}} || nein || nein || ja || {{td_yellow|unbekannt}} || [[#bytecamp|Details]]
|-
| [http://www.bplaced.net bplaced] (Freehoster, in den Userseiten werbefrei) || Free || nein || nein || nein || nein || {{td_red |nein}} | {{td_red |nein}} || [[#bplaced|Details]]
|-
|CanHost || CAN-NUKE und andere || nein || nein || {{td_red |ja}} || nein || ja || ja || [[#CanHost|Details]]
|-
| [http://www.celeros.de Celeros] || Private || nein || nein || nein || nein || ja || {{td_yellow|unbekannt}} ||keine
|-
| [http://www.contao-webhosting.de Contao Webhosting] || ab Paket S || nein || nein || nein || nein || ja || ja || keine
|-
| [http://www.cyon.ch Cyon] || Cherry, KIWI || nein || laut Nutzer "zed" inzwischen nicht mehr nötig, PHP5 nun Standard || nein || nein || ja || ja || keine
|-
| [http://www.df.eu DomainFactory] || ManagedHosting L, ManagedHosting M, My Home Vorkonfiguration 1, My Home Dynamic || nein || nein || nein || nein || ja || ja || keine
|-
| [http://www.dynamic-net.ch dynamic-net] || Alle Pakete inkl. Reseller || nein || nein || nein || nein || ja || ja || [[#dynamic-net|Details]]
|-
| [https://www.fc-hosting.de fc-hosting] || Profi-2 || nein || nein || nein || nein || ja || ja || [[#fc-hosting|Details]]
|-
| [http://www.flyhost.de FlyHost] || Flyhost 100, Flyhost 50 || nein || nein || nein || nein || ja || {{td_yellow |unbekannt}} || keine
|-
| [http://www.genotec.ch Genotec] || Shared Pro UNIX || nein || nein || nein || nein || {{td_red | SOAP}} | {{td_yellow |unbekannt}} || keine
|-
| [http://www.goneo.de goneo] || Homepage Easy, Profi und Premium || nein || nein || nein || nein || ja || ja || [[#goneo|Details]]
|-
| [http://www.greatnet.de Greatnet] || Classic || nein || {{td_red |PHP 5 }} || nein || nein || ja || ja || [[#Greatnet|Details]]
|-
| [http://www.hetzner.de Hetzner] || ab dem Paket "Level 4" voll kompatibel || nein || nein || nein || nein || ja || ja || keine
|-
| [http://www.host4free.de Host4Free] || individueller Tarif || nein || nein || nein || nein || ja || ja || [[#Host4Free|Details]]
|-
| [http://www.hosteurope.de Hosteurope] || ab Webpack M || nein || nein || nein || nein || ja || ja || [[#Hosteurope|Details]]
|-
| [http://www.hosting-agency.de Hosting-Agency] || Agency 250 || nein || nein || nein || nein || {{td_red | SOAP}} || ja || keine
|-
| [http://www.hostmonster.com Hostmonster] || - || nein || nein || nein || nein || {{td_yellow |unbekannt}} | {{td_yellow |unbekannt}} || keine
|-
| [http://www.hostmax.ch HostMax] || One || nein || nein || nein || nein || nein || ja || [[#HostMax|Details]]
|-
| [http://www.hostpoint.ch Hostpoint] || SH Server Standard || nein || nein || nein || nein || ja || ja || [[#Hostpoint|Details]]
|-
| [http://www.hoststar.ch Hoststar] || StarEntry || nein || {{td_red |PHP 5}} | {{td_red |mod_rewrite aktivieren lassen}} || nein || {{td_yellow | SOAP}} || ja || [[#Hoststar|Details]]
|-
| [http://www.hosttech.de hosttech] || Easy 10000 || {{td_red |Ja}} || nein || nein || nein || ja || {{td_yellow |unbekannt}} || keine
|-
| [http://www.inetrobots.com iNet Robots] || ab Web Home || nein || nein || nein || nein || ja || ja || keine
|-
| [http://www.intersaar.de intersaar] || ab Web-Präsenz "Eco" aufwärts ("Eco", "Business", "Professional", "Premium") gut geeignet. || nein || nein || nein || nein || {{td_yellow | SOAP}} | {{td_yellow |unbekannt}} || [[#intersaar|Details]]
|-
| [http://www.mittwald.de Mittwald] || - || nein || nein || nein || nein || ja || ja || keine
|-
| [http://www.one.com One.com] || 3000MB || {{td_yellow |unbekannt}} || nein || nein || nein || ja || {{td_yellow |unbekannt}} || keine
|-
| [http://www.strato.de Strato] || Strato PowerPlus, Strato Speedplus || nein || {{td_red |PHP 5 bei älteren Hostings }} || nein || nein || {{td_red | SOAP}} | {{td_yellow |unbekannt}} || [[#Strato|Details]]
|-
| [http://www.suleitec.de Suleitec] || ab Tarif Expert || nein || nein || nein || nein || {{td_yellow |unbekannt}} | {{td_yellow |unbekannt}} || keine
|-
| [http://www.tecserver.com TecServer] || Webhosting Small || nein || nein || nein || nein || ja || ja || keine
|-
| [http://www.tng.de TNG] || VLAMP-Server || nein || nein || nein || nein || ja || ja || [[#TNG|Details]]
|-
|[http://www.tophoster.de tophoster.de] || alle || nein || nein || nein || nein || ja || ja || keine
|-
| [https://uberspace.de Uberspace] || Uberspace arbeitet mit einem einzigen Tarifmodell || nein || nein || nein || nein || ja || {{td_yellow|unbekannt}} || [[#Uberspace|Details]]
|-
| [http://www.united-domains.de united-domains] || Standard || nein || nein || nein || nein || ja || ja || keine
|-
| [http://www.web.de web.de] || colspan="8" | Siehe [[1 und 1 Internet]] da web.de eine Tochtergesellschaft ist.
|-
| [http://www.webhoster.de webhoster.de] || Webhosting Starter Tarif || nein || nein || nein || nein || ja || ja || keine
|-
|[http://www.webhostone.de WebhostOne] || ab Basic-300 (Carino: empfohlen Basic 750), Pro-1500 || nein || nein || nein || nein || ja || ja || [[#WebhostOne|Details]]
|-
| [http://www.world4you.com World4You] || Domainserver Start || nein || nein || nein || nein || ja || ja || [[#World4You|Details]]
|-
|}

* Im [http://www.contao-community.de/showthread.php?66-Hosting-von-Contao-Installationen Contao-Forum] findet sich ebenfalls eine (evtl. aktuellere) [http://www.contao-community.de/showthread.php?66-Hosting-von-Contao-Installationen Übersicht über Contao-kompatible Webhoster].

=Liste inkompatibler Webhoster=
In dieser Liste werden Webhoster gelistet, bei denen Contao nicht eingesetzt werden kann oder sollte, da sie die Nutzung wichtiger Systemfunktionen deaktivieren.
Bitte beim Hinzufügen von Webhostern darauf achten, detailliert zu beschreiben woran es scheitert, wie z.B. "stellt nur PHP4 zur Verfügung", alternativ kann auch der Inhalt des betreffenden Forum-Threads rezitiert werden und selbiger Thread als Sonstige Anmerkung verlinkt werden.

{| border="0" cellpadding="5" cellspacing="1" style="margin:0;vertical-align:top;"
|+ <big>'''Diese Informationen basieren ausschließlich auf Erfahrungen von Nutzern. Diese Erfahrungen stimmen teilweise nicht für alle Webpakete eines Anbieters! Manchmal ändern Anbieter auch die technischen Einstellungen, so dass sich neue Umstände ergeben. Verlasst euch niemals nur darauf, sondern führt wenn möglich mindestens eine Diagnose, am besten aber eine Testinstallation auf einem Test-Webspace (beim Anbieter nachfragen) durch.'''</big>
|-
!Webhoster
!Grund der Inkompatibilität
!Sonstige Anmerkungen
|-
| [http://www.1a-websolutions.ch 1a-websolutions] || Verwendet mod_security, welches das Datenbank-Update lahm legt. || [http://www.contao-community.de/showthread.php?5895-Fehlermeldung-bei-der-Installatio Forum-Thread]
|-
|[http://www.t-online.de T-Online] ||Unterstützt keinen .htaccess Dateien. Daher keine URL-Umschreibung und keine Absicherung von Verzeichnissen. || [http://www.contao-community.de/showthread.php?5621-t-online Forum-Thread]
|}

=Workarounds für bestimmte Webhoster=
Bei manchen Webhostern ist es leider notwendig von [[Installation|Standard Installationsschema]] abzuweichen. Oftmals betrifft dies den so genannten [[Safemode Hack]], welcher bei etlichen Webhostern notwendig ist. Weiterhin ist oftmals die SOAP Erweiterung nicht in PHP enthalten, was den Erweiterungskatalog nicht verwendbar macht (Mögliche Abhilfe hierbei ist jedoch [[TensideRepository]] für TYPOlight oder [[nusoap]] für Contao).

Diese Besonderheiten sind hier aufgeführt um zu ermöglichen, dass Contao bei diesen Webhostern läuft.

==1blu==
PHP muss mittels einer im Verzeichnis abzulegenden Konfigurationsdatei auf Version 5 umgestellt werden. Problemlos und in den 1Blu-FAQ gut erklärt.
==Alfahosting==
One-Click-Installation von Contao.
==All-Inkl==
PHP 5 Aktivierung in .htaccess: 
<source lang="text">AddHandler php5-cgi .php</source>
==Arcor==
Läuft sehr langsam, Premium-Pakete mit weniger Kunden pro Server gibt es nicht. Safe_Mode ist aktiviert, die Seite funktioniert trotzdem, nur eben sehr langsam.
==bytecamp==
PHP 5 Aktivierung in .htaccess:
<source lang="text">AddType application/x-httpd-php5 .php</source>
Vereinfache Installation und PHP5 vorkonfiguriert durch eigenen Installer. [http://www.bytecamp.net/de/hosting/details/installer.html 3 Schritte bequem per Webbrowser. ]
==bplaced==
Laut User [http://www.contao-community.de/showthread.php?7436-PHP-Version-5.3.2&highlight=bplaced tommy] gibt es inzwischen Ärger mit diesem Freehoster.
==CanHost==
Hängt stark vom gebuchten Paket ab, einige Änderungen sind im IP-Conf möglich, sonstige sind häufig per Mail an Support machbar. 
Kein Backup von Webspace und Datenbanken im Preis enthalten (hinzubuchbar). 
Teilweise nur kurzes PHP-Zeitlimit (Support um Aufstockung bitten). 
Sehr unterschiedliche Konfigurationen der Server (auch bei gleichen Hosting-Paketen). 
In der Vergangenheit auch zeitweise Ausfälle; Domain teilweise nicht erreichbar. 
Einige ausgewählte php.ini-Parameter lassen sich im IP-Conf (Konfigurationstool) selbst einstellen. 
Über den Support kann man fast immer die benötigten Einstellungen bekommen (Beispiele: allow_url_fopen=On, max_execution_time=30, upload_max_filesize=8M, mcrypt aktiviert, SOAP installiert). 
Nicht in allen Paketen läßt sich der Safe-Mode einstellen (safe_mode = Off).
==dynamic-net==
Falls das Extension Repository nicht ersichtlich ist, reicht ein kurzes Supportticket, um SOAP freischalten zu lassen.
==fc-hosting==
Newsletterversand möglich, aber nur blockweise (100Stk.).
==goneo==
Nur .de Domains gelten als Inklusivdomains, andere müssen kostenpflichtig zugebucht werden.
Nutzung des Composers ist mit PHP 5.3 nicht möglich, da allow_url_fopen standardmäßig und nicht änderbar auf Off gesetzt ist. 
Wer auf PHP 5.4 umstellt, hat die Möglichkeit eine eigene php.ini zu nutzen.
Das nachfolgende PHP-Script muss auf den Webserver kopiert (z.B. als copyini.php) und aufgerufen werden (z.B. mit http://www.domain.de/copyini.php)
<source lang="php">
<?php
$cfg = get_cfg_var( 'cfg_file_path' );
if ( copy( $cfg , './php.ini' ) )
{
echo "Kopieren erfolgreich";
}
else
{
echo "Kopieren fehlgeschlagen";
}
?>
</source>
Das PHP-Script kopiert die aktuelle php.ini in den Ordner, wo auch das Script liegt. Anschließend sollte man das Script (copyini.php) wieder löschen.

Für Contao + Composer muss man die kopierte php.ini anpassen. Dazu ändert man die Angabe
<source lang="php">
allow_url_fopen = Off
</source>
zu
<source lang="php">
allow_url_fopen = On
</source>

Diese geänderte php.ini kopiert man nun in die Verzeichnisse TL_ROOT/contao und optional nach TL_ROOT/check.
Damit läuft nun das Backend mit der geänderten php.ini und der Contao-Check, sofern installiert. Aus dem Verzeichnis TL_ROOT kann man die geänderte php.ini nun löschen.

==Greatnet==
PHP 5 Aktivierung in .htaccess:
<source lang="text">FCGIWrapper /home/www/*DEINWEB*/fcgid/php5-fcgid .php</source>
==Host4Free==
Für größere Websites wird ein Paket ab 4maxi empfohlen, da hier mehr Arbeitsspeicher pro Prozess zur Verfügung steht.
==Hosteurope==
Gilt seit 2011. Hochladen der Contao-Dateien: FTP-Zugang muss als Webserver-Benutzer konfiguriert sein (In allen neuen Paketen Standardeinstellung). Sonst ist der Safemod Hack notwendig.

=== Composer und LiveUpdate ===
Für die Nutzung von Composer und dem LiveUpdate-Service muss im KIS von Hosteurope eine Anpassung vorgenommen werden, die die Nutzung von .phar-Dateien unter Suhosin erlaubt. Dazu muss man sich im KIS einloggen. Dann sollte man in der linken Navigation unter dem Punkt "Administration" die Seite "Webserver" besuchen. Im Hauptbereich erscheint nun die Auflistung der jeweiligen Webpakete bzw. Server. Dort sollte man dann das jeweilige Paket mit dem passenden Button "Konfigurieren". Jetzt ruft man den Punkt "Skripte" auf und dann den Unterpunkt "Skripteinstellungen". In der nun erscheinenden Tabelle zu den php-Einstellungen klickt man bei dem Eintrag "PHP Suhosin Executor Include Whitelist" auf "ändern". Unter dem nun erscheinenden Screen sollte die Checkbox für "phar" aktiviert sein. Diese Einstellung sollte nun gespeichert werden und der Nutzung von Composer und dem LiveUpdate-Service sollte nun nichts mehr im Wege stehen.

[[Datei:hosteurope_phar_01.jpg|200px|Script-Einstellung vor der Anpassung]] [[Datei:hosteurope_phar_02.jpg|200px|Script-Einstellung Details]] [[Datei:hosteurope_phar_03.jpg|200px|Script-Einstellung nach der Anpassung]]

==HostMax==
E-Mail an info@hostmax.ch senden, und mitteilen, dass Contao verwendet wird. HostMax muss die FireWall-Filter anpassen für Contao, sonst können Einstellungen im Backend nicht gesichert werden.
==Hostpoint==
Anscheinend läuft bei Hostpoint [http://www.contao-community.de/showpost.php?p=30104&postcount=32 TCPDF nicht wie gewünscht].
==Hoststar==
Über my.hoststar.ch ein Ticket erstellen für SOAP Aktivierung. Dann kommt meistens eine Antwort wie "das sei unsicher". Durch Beharrlichkeit und klar machen, dass SOAP kein Sicherheitsrisiko darstellt, kann eine Aktivierung erreicht werden.
==intersaar==
Bei Vertragsschluß am Besten gleich angeben, dass SOAP-Extensions aktiviert werden sollen.
==Strato==
Pakete, die jetzt neu gebucht werden, haben bereits PHP5 aktiviert. PHP4 gibt es bei neuen Paketen nicht mehr.

In den neuen Paketen (z.B. BasicWeb XL) muss man in der localconfig.php ggf. diese Zeile nach(!) "### INSTALL SCRIPT STOP ###" hinzufügen:
<source lang="text">unset($_SERVER['HTTP_X_FORWARDED_HOST']);</source>
Teilweise sehr langsam im Datenbankzugriff.

===PHP5 bei Alt-Hostings===
Bei einem länger existierenden Paket muss unter Umständen PHP5 aktiviert werden. Dies '''muss''' im Kundencenter erfolgen (wie weiter unten von planepix beschrieben).

''Anmerkung von tril:'' Diese Methode scheint nicht mehr zu funktionieren und führt idR zu einem 500er Fehler, dies kann aber von Paket zu Paket unterschiedlich sein, deshalb hier nochmal die '''alte Methode''' um PHP5 zu aktivieren:
<source lang="text">AddHandler application/x-httpd-php5 .php</source>
''Anmerkung von planepix:'' Alternativ kann man sich im Kundencenter von Strato einloggen und links im Menü unter "Homepagestaltung" die Option "Website-Konfigurator" wählen. Dort gibt es den Punkt "PHP-Konfiguration" mit dem man die PHP-Version fürs Verzeichnis auf PHP5 einstellen kann. 

==TNG==
Aktivierung von mod_rewrite via Support.

==Uberspace==
Default ist PHP 5.4. In PHP 5.4 wurden für Zlib die neuen Konstanten ZLIB_ENCODING_DEFLATE, ZLIB_ENCODING_GZIP und ZLIB_ENCODING_RAW eingeführt.

Bedingt durch einen Bug in SOAP ist es nötig, in Contao 2.11.x die folgenden Änderungen in der Datei /system/modules/rep_client/RepositoryBackendModule.php vorzunehmen:
<source lang="php">diff --git a/system/modules/rep_client/RepositoryBackendModule.php b/system/modules/rep_client/RepositoryBackendModule.php
index d04626c..ff8b0f4 100644
--- a/system/modules/rep_client/RepositoryBackendModule.php
+++ b/system/modules/rep_client/RepositoryBackendModule.php
@@ -124,7 +124,7 @@ class RepositoryBackendModule extends BackendModule
$proxy_uri = parse_url($GLOBALS['TL_CONFIG']['proxy_url']);
$this->client = new SoapClient($wsdl, array(
'soap_version' => SOAP_1_2,
- 'compression' => SOAP_COMPRESSION_ACCEPT | SOAP_COMPRESSION_GZIP | 1,
+ 'compression' => SOAP_COMPRESSION_ACCEPT | SOAP_COMPRESSION_GZIP,
'proxy_host' => $proxy_uri['host'],
'proxy_port' => $proxy_uri['port'],
'proxy_login' => $proxy_uri['user'],
@@ -135,7 +135,7 @@ class RepositoryBackendModule extends BackendModule
else {
$this->client = new SoapClient($wsdl, array(
'soap_version' => SOAP_1_2,
- 'compression' => SOAP_COMPRESSION_ACCEPT | SOAP_COMPRESSION_GZIP | 1
+ 'compression' => SOAP_COMPRESSION_ACCEPT | SOAP_COMPRESSION_GZIP
));
}
$this->mode = 'soap';</source>

Bei älteren Uberspaces, die vor dem Erscheinen der neuen PHP-Version erstellt worden sind, wird PHP 5.4 noch nicht automatisch aktiviert, dort müssen diese Änderungen nicht vorgenommen werden.

Bei neueren Uberspaces ist es außerdem möglich, wenn es sein muss, auf eine ältere PHP-Version (beispielsweise 5.3) umzuschalten. Dies ist [https://uberspace.de/dokuwiki/development:php#php-version_einstellen hier] beschrieben.

==WebhostOne==
[http://www.contao.org/neuigkeiten/items/typolight-als-1click-installation.html 1 Klick Installation von TL] Man kann bei speziellen Wünschen httpd.conf und php.ini selbst anpassen. Wenn man sich nicht so gut damit auskennt, kann man sogar im kostenlosen SupportChat fragen, wie man welchen Befehl schreiben muss.
==World4You==
Live Update URL ev. vom Support freischalten lassen. Contao als Easy-Install im Kundencenter verfügbar.

Webhoster

2014-08-18T21:04:50Z

BugBuster: /* goneo */

[[Category:Installation und Updates]]
=Liste kompatibler Webhoster=
<big>'''Diese Informationen basieren ausschließlich auf Erfahrungen von Nutzern. Diese Erfahrungen stimmen teilweise nicht für alle Webpakete eines Anbieters! Manchmal ändern Anbieter auch die technischen Einstellungen, so dass sich neue Umstände ergeben. Verlasst euch niemals nur darauf, sondern führt wenn möglich mindestens eine Diagnose, am besten aber eine Testinstallation auf einem Test-Webspace (beim Anbieter nachfragen) durch.'''</big>

Abkürzungen:
* SMH = [[Safemode Hack]]
* ER = [[Systemdiagnosetool#PHP_configuration|Extension Repository]] (siehe ''SOAP extension'')
* LU = Live Update

{| border="0" cellpadding="5" cellspacing="1" style="vertical-align:top;"

|-
!Webhoster
!Tarif
!SMH notwendig
!.htaccess notwendig
!php.ini notwendig
!CHMOD notwendig
!ER möglich
!LU möglich
!Sonstige Anmerkungen
|-
| [http://www.1und1.de 1&1] || ab 1&1 Homepage Perfect || nein || {{td_red |PHP 5}} || nein || nein || ja || ja || [[1 und 1 Internet|detaillierte Installationsanleitung]]
|-
| [http://www.1blu.de 1blu] || Homepage Unlimited, Homepage Professional || nein || nein || nein || nein || ja || ja || [[#1blu|Details]]
|-
| [http://alfahosting.de Alfahosting] || Multipaket, Profipaket, Businesspaket || nein || nein || nein || nein || ja || ja || [[#Alfahosting|Details]]
|-
| [http://all-inkl.com All-Inkl] || ab "Start" Tarif || nein || {{td_red| PHP 5}} || nein || nein || ja || ja || [[#All-Inkl|Details]]
|-
| [http://www.arcor.de Arcor] || 700 MB Webspace || {{td_yellow |unbekannt}} || nein || nein || nein || {{td_red | SOAP}} || ja || [[#Arcor|Details]]
|-
| [http://www.bytecamp.net bytecamp] || bytecamp arbeitet mit einem einzigen Tarifmodell || nein || {{td_red |PHP 5}} || nein || nein || ja || {{td_yellow|unbekannt}} || [[#bytecamp|Details]]
|-
| [http://www.bplaced.net bplaced] (Freehoster, in den Userseiten werbefrei) || Free || nein || nein || nein || nein || {{td_red |nein}} | {{td_red |nein}} || [[#bplaced|Details]]
|-
|CanHost || CAN-NUKE und andere || nein || nein || {{td_red |ja}} || nein || ja || ja || [[#CanHost|Details]]
|-
| [http://www.celeros.de Celeros] || Private || nein || nein || nein || nein || ja || {{td_yellow|unbekannt}} ||keine
|-
| [http://www.contao-webhosting.de Contao Webhosting] || ab Paket S || nein || nein || nein || nein || ja || ja || keine
|-
| [http://www.cyon.ch Cyon] || Cherry, KIWI || nein || laut Nutzer "zed" inzwischen nicht mehr nötig, PHP5 nun Standard || nein || nein || ja || ja || keine
|-
| [http://www.df.eu DomainFactory] || ManagedHosting L, ManagedHosting M, My Home Vorkonfiguration 1, My Home Dynamic || nein || nein || nein || nein || ja || ja || keine
|-
| [http://www.dynamic-net.ch dynamic-net] || Alle Pakete inkl. Reseller || nein || nein || nein || nein || ja || ja || [[#dynamic-net|Details]]
|-
| [https://www.fc-hosting.de fc-hosting] || Profi-2 || nein || nein || nein || nein || ja || ja || [[#fc-hosting|Details]]
|-
| [http://www.flyhost.de FlyHost] || Flyhost 100, Flyhost 50 || nein || nein || nein || nein || ja || {{td_yellow |unbekannt}} || keine
|-
| [http://www.genotec.ch Genotec] || Shared Pro UNIX || nein || nein || nein || nein || {{td_red | SOAP}} | {{td_yellow |unbekannt}} || keine
|-
| [http://www.goneo.de goneo] || Homepage Easy, Profi und Premium || nein || nein || nein || nein || ja || ja || [[#goneo|Details]]
|-
| [http://www.greatnet.de Greatnet] || Classic || nein || {{td_red |PHP 5 }} || nein || nein || ja || ja || [[#Greatnet|Details]]
|-
| [http://www.hetzner.de Hetzner] || ab dem Paket "Level 4" voll kompatibel || nein || nein || nein || nein || ja || ja || keine
|-
| [http://www.host4free.de Host4Free] || individueller Tarif || nein || nein || nein || nein || ja || ja || [[#Host4Free|Details]]
|-
| [http://www.hosteurope.de Hosteurope] || ab Webpack M || nein || nein || nein || nein || ja || ja || [[#Hosteurope|Details]]
|-
| [http://www.hosting-agency.de Hosting-Agency] || Agency 250 || nein || nein || nein || nein || {{td_red | SOAP}} || ja || keine
|-
| [http://www.hostmonster.com Hostmonster] || - || nein || nein || nein || nein || {{td_yellow |unbekannt}} | {{td_yellow |unbekannt}} || keine
|-
| [http://www.hostmax.ch HostMax] || One || nein || nein || nein || nein || nein || ja || [[#HostMax|Details]]
|-
| [http://www.hostpoint.ch Hostpoint] || SH Server Standard || nein || nein || nein || nein || ja || ja || [[#Hostpoint|Details]]
|-
| [http://www.hoststar.ch Hoststar] || StarEntry || nein || {{td_red |PHP 5}} | {{td_red |mod_rewrite aktivieren lassen}} || nein || {{td_yellow | SOAP}} || ja || [[#Hoststar|Details]]
|-
| [http://www.hosttech.de hosttech] || Easy 10000 || {{td_red |Ja}} || nein || nein || nein || ja || {{td_yellow |unbekannt}} || keine
|-
| [http://www.inetrobots.com iNet Robots] || ab Web Home || nein || nein || nein || nein || ja || ja || keine
|-
| [http://www.intersaar.de intersaar] || ab Web-Präsenz "Eco" aufwärts ("Eco", "Business", "Professional", "Premium") gut geeignet. || nein || nein || nein || nein || {{td_yellow | SOAP}} | {{td_yellow |unbekannt}} || [[#intersaar|Details]]
|-
| [http://www.mittwald.de Mittwald] || - || nein || nein || nein || nein || ja || ja || keine
|-
| [http://www.one.com One.com] || 3000MB || {{td_yellow |unbekannt}} || nein || nein || nein || ja || {{td_yellow |unbekannt}} || keine
|-
| [http://www.strato.de Strato] || Strato PowerPlus, Strato Speedplus || nein || {{td_red |PHP 5 bei älteren Hostings }} || nein || nein || {{td_red | SOAP}} | {{td_yellow |unbekannt}} || [[#Strato|Details]]
|-
| [http://www.suleitec.de Suleitec] || ab Tarif Expert || nein || nein || nein || nein || {{td_yellow |unbekannt}} | {{td_yellow |unbekannt}} || keine
|-
| [http://www.tecserver.com TecServer] || Webhosting Small || nein || nein || nein || nein || ja || ja || keine
|-
| [http://www.tng.de TNG] || VLAMP-Server || nein || nein || nein || nein || ja || ja || [[#TNG|Details]]
|-
|[http://www.tophoster.de tophoster.de] || alle || nein || nein || nein || nein || ja || ja || keine
|-
| [https://uberspace.de Uberspace] || Uberspace arbeitet mit einem einzigen Tarifmodell || nein || nein || nein || nein || ja || {{td_yellow|unbekannt}} || [[#Uberspace|Details]]
|-
| [http://www.united-domains.de united-domains] || Standard || nein || nein || nein || nein || ja || ja || keine
|-
| [http://www.web.de web.de] || colspan="8" | Siehe [[1 und 1 Internet]] da web.de eine Tochtergesellschaft ist.
|-
| [http://www.webhoster.de webhoster.de] || Webhosting Starter Tarif || nein || nein || nein || nein || ja || ja || keine
|-
|[http://www.webhostone.de WebhostOne] || ab Basic-300 (Carino: empfohlen Basic 750), Pro-1500 || nein || nein || nein || nein || ja || ja || [[#WebhostOne|Details]]
|-
| [http://www.world4you.com World4You] || Domainserver Start || nein || nein || nein || nein || ja || ja || [[#World4You|Details]]
|-
|}

* Im [http://www.contao-community.de/showthread.php?66-Hosting-von-Contao-Installationen Contao-Forum] findet sich ebenfalls eine (evtl. aktuellere) [http://www.contao-community.de/showthread.php?66-Hosting-von-Contao-Installationen Übersicht über Contao-kompatible Webhoster].

=Liste inkompatibler Webhoster=
In dieser Liste werden Webhoster gelistet, bei denen Contao nicht eingesetzt werden kann oder sollte, da sie die Nutzung wichtiger Systemfunktionen deaktivieren.
Bitte beim Hinzufügen von Webhostern darauf achten, detailliert zu beschreiben woran es scheitert, wie z.B. "stellt nur PHP4 zur Verfügung", alternativ kann auch der Inhalt des betreffenden Forum-Threads rezitiert werden und selbiger Thread als Sonstige Anmerkung verlinkt werden.

{| border="0" cellpadding="5" cellspacing="1" style="margin:0;vertical-align:top;"
|+ <big>'''Diese Informationen basieren ausschließlich auf Erfahrungen von Nutzern. Diese Erfahrungen stimmen teilweise nicht für alle Webpakete eines Anbieters! Manchmal ändern Anbieter auch die technischen Einstellungen, so dass sich neue Umstände ergeben. Verlasst euch niemals nur darauf, sondern führt wenn möglich mindestens eine Diagnose, am besten aber eine Testinstallation auf einem Test-Webspace (beim Anbieter nachfragen) durch.'''</big>
|-
!Webhoster
!Grund der Inkompatibilität
!Sonstige Anmerkungen
|-
| [http://www.1a-websolutions.ch 1a-websolutions] || Verwendet mod_security, welches das Datenbank-Update lahm legt. || [http://www.contao-community.de/showthread.php?5895-Fehlermeldung-bei-der-Installatio Forum-Thread]
|-
|[http://www.t-online.de T-Online] ||Unterstützt keinen .htaccess Dateien. Daher keine URL-Umschreibung und keine Absicherung von Verzeichnissen. || [http://www.contao-community.de/showthread.php?5621-t-online Forum-Thread]
|}

=Workarounds für bestimmte Webhoster=
Bei manchen Webhostern ist es leider notwendig von [[Installation|Standard Installationsschema]] abzuweichen. Oftmals betrifft dies den so genannten [[Safemode Hack]], welcher bei etlichen Webhostern notwendig ist. Weiterhin ist oftmals die SOAP Erweiterung nicht in PHP enthalten, was den Erweiterungskatalog nicht verwendbar macht (Mögliche Abhilfe hierbei ist jedoch [[TensideRepository]] für TYPOlight oder [[nusoap]] für Contao).

Diese Besonderheiten sind hier aufgeführt um zu ermöglichen, dass Contao bei diesen Webhostern läuft.

==1blu==
PHP muss mittels einer im Verzeichnis abzulegenden Konfigurationsdatei auf Version 5 umgestellt werden. Problemlos und in den 1Blu-FAQ gut erklärt.
==Alfahosting==
One-Click-Installation von Contao.
==All-Inkl==
PHP 5 Aktivierung in .htaccess: 
<source lang="text">AddHandler php5-cgi .php</source>
==Arcor==
Läuft sehr langsam, Premium-Pakete mit weniger Kunden pro Server gibt es nicht. Safe_Mode ist aktiviert, die Seite funktioniert trotzdem, nur eben sehr langsam.
==bytecamp==
PHP 5 Aktivierung in .htaccess:
<source lang="text">AddType application/x-httpd-php5 .php</source>
Vereinfache Installation und PHP5 vorkonfiguriert durch eigenen Installer. [http://www.bytecamp.net/de/hosting/details/installer.html 3 Schritte bequem per Webbrowser. ]
==bplaced==
Laut User [http://www.contao-community.de/showthread.php?7436-PHP-Version-5.3.2&highlight=bplaced tommy] gibt es inzwischen Ärger mit diesem Freehoster.
==CanHost==
Hängt stark vom gebuchten Paket ab, einige Änderungen sind im IP-Conf möglich, sonstige sind häufig per Mail an Support machbar. 
Kein Backup von Webspace und Datenbanken im Preis enthalten (hinzubuchbar). 
Teilweise nur kurzes PHP-Zeitlimit (Support um Aufstockung bitten). 
Sehr unterschiedliche Konfigurationen der Server (auch bei gleichen Hosting-Paketen). 
In der Vergangenheit auch zeitweise Ausfälle; Domain teilweise nicht erreichbar. 
Einige ausgewählte php.ini-Parameter lassen sich im IP-Conf (Konfigurationstool) selbst einstellen. 
Über den Support kann man fast immer die benötigten Einstellungen bekommen (Beispiele: allow_url_fopen=On, max_execution_time=30, upload_max_filesize=8M, mcrypt aktiviert, SOAP installiert). 
Nicht in allen Paketen läßt sich der Safe-Mode einstellen (safe_mode = Off).
==dynamic-net==
Falls das Extension Repository nicht ersichtlich ist, reicht ein kurzes Supportticket, um SOAP freischalten zu lassen.
==fc-hosting==
Newsletterversand möglich, aber nur blockweise (100Stk.).
==Goneo==
Nur .de Domains gelten als Inklusivdomains, andere müssen kostenpflichtig zugebucht werden.
Nutzung des Composers ist mit PHP 5.3 nicht möglich, da allow_url_fopen standardmäßig und nicht änderbar auf Off gesetzt ist. 
Wer auf PHP 5.4 umstellt, hat die Möglichkeit eine eigene php.ini zu nutzen.
Das nachfolgende PHP-Script muss auf den Webserver kopiert (z.B. als copyini.php) und aufgerufen werden (z.B. mit http://www.domain.de/copyini.php)
<source lang="php">
<?php
$cfg = get_cfg_var( 'cfg_file_path' );
if ( copy( $cfg , './php.ini' ) )
{
echo "Kopieren erfolgreich";
}
else
{
echo "Kopieren fehlgeschlagen";
}
?>
</source>
Das PHP-Script kopiert die aktuelle php.ini in den Ordner, wo auch das Script liegt. Anschließend sollte man das Script (copyini.php) wieder löschen.

Für Contao + Composer muss man die kopierte php.ini anpassen. Dazu ändert man die Angabe
<source lang="php">
allow_url_fopen = Off
</source>
zu
<source lang="php">
allow_url_fopen = On
</source>

Diese geänderte php.ini kopiert man nun in die Verzeichnisse TL_ROOT/contao und optional nach TL_ROOT/check.
Damit läuft nun das Backend mit der geänderten php.ini und der Contao-Check, sofern installiert. Aus dem Verzeichnis TL_ROOT kann man die geänderte php.ini nun löschen.

==Greatnet==
PHP 5 Aktivierung in .htaccess:
<source lang="text">FCGIWrapper /home/www/*DEINWEB*/fcgid/php5-fcgid .php</source>
==Host4Free==
Für größere Websites wird ein Paket ab 4maxi empfohlen, da hier mehr Arbeitsspeicher pro Prozess zur Verfügung steht.
==Hosteurope==
Gilt seit 2011. Hochladen der Contao-Dateien: FTP-Zugang muss als Webserver-Benutzer konfiguriert sein (In allen neuen Paketen Standardeinstellung). Sonst ist der Safemod Hack notwendig.

=== Composer und LiveUpdate ===
Für die Nutzung von Composer und dem LiveUpdate-Service muss im KIS von Hosteurope eine Anpassung vorgenommen werden, die die Nutzung von .phar-Dateien unter Suhosin erlaubt. Dazu muss man sich im KIS einloggen. Dann sollte man in der linken Navigation unter dem Punkt "Administration" die Seite "Webserver" besuchen. Im Hauptbereich erscheint nun die Auflistung der jeweiligen Webpakete bzw. Server. Dort sollte man dann das jeweilige Paket mit dem passenden Button "Konfigurieren". Jetzt ruft man den Punkt "Skripte" auf und dann den Unterpunkt "Skripteinstellungen". In der nun erscheinenden Tabelle zu den php-Einstellungen klickt man bei dem Eintrag "PHP Suhosin Executor Include Whitelist" auf "ändern". Unter dem nun erscheinenden Screen sollte die Checkbox für "phar" aktiviert sein. Diese Einstellung sollte nun gespeichert werden und der Nutzung von Composer und dem LiveUpdate-Service sollte nun nichts mehr im Wege stehen.

[[Datei:hosteurope_phar_01.jpg|200px|Script-Einstellung vor der Anpassung]] [[Datei:hosteurope_phar_02.jpg|200px|Script-Einstellung Details]] [[Datei:hosteurope_phar_03.jpg|200px|Script-Einstellung nach der Anpassung]]

==HostMax==
E-Mail an info@hostmax.ch senden, und mitteilen, dass Contao verwendet wird. HostMax muss die FireWall-Filter anpassen für Contao, sonst können Einstellungen im Backend nicht gesichert werden.
==Hostpoint==
Anscheinend läuft bei Hostpoint [http://www.contao-community.de/showpost.php?p=30104&postcount=32 TCPDF nicht wie gewünscht].
==Hoststar==
Über my.hoststar.ch ein Ticket erstellen für SOAP Aktivierung. Dann kommt meistens eine Antwort wie "das sei unsicher". Durch Beharrlichkeit und klar machen, dass SOAP kein Sicherheitsrisiko darstellt, kann eine Aktivierung erreicht werden.
==intersaar==
Bei Vertragsschluß am Besten gleich angeben, dass SOAP-Extensions aktiviert werden sollen.
==Strato==
Pakete, die jetzt neu gebucht werden, haben bereits PHP5 aktiviert. PHP4 gibt es bei neuen Paketen nicht mehr.

In den neuen Paketen (z.B. BasicWeb XL) muss man in der localconfig.php ggf. diese Zeile nach(!) "### INSTALL SCRIPT STOP ###" hinzufügen:
<source lang="text">unset($_SERVER['HTTP_X_FORWARDED_HOST']);</source>
Teilweise sehr langsam im Datenbankzugriff.

===PHP5 bei Alt-Hostings===
Bei einem länger existierenden Paket muss unter Umständen PHP5 aktiviert werden. Dies '''muss''' im Kundencenter erfolgen (wie weiter unten von planepix beschrieben).

''Anmerkung von tril:'' Diese Methode scheint nicht mehr zu funktionieren und führt idR zu einem 500er Fehler, dies kann aber von Paket zu Paket unterschiedlich sein, deshalb hier nochmal die '''alte Methode''' um PHP5 zu aktivieren:
<source lang="text">AddHandler application/x-httpd-php5 .php</source>
''Anmerkung von planepix:'' Alternativ kann man sich im Kundencenter von Strato einloggen und links im Menü unter "Homepagestaltung" die Option "Website-Konfigurator" wählen. Dort gibt es den Punkt "PHP-Konfiguration" mit dem man die PHP-Version fürs Verzeichnis auf PHP5 einstellen kann. 

==TNG==
Aktivierung von mod_rewrite via Support.

==Uberspace==
Default ist PHP 5.4. In PHP 5.4 wurden für Zlib die neuen Konstanten ZLIB_ENCODING_DEFLATE, ZLIB_ENCODING_GZIP und ZLIB_ENCODING_RAW eingeführt.

Bedingt durch einen Bug in SOAP ist es nötig, in Contao 2.11.x die folgenden Änderungen in der Datei /system/modules/rep_client/RepositoryBackendModule.php vorzunehmen:
<source lang="php">diff --git a/system/modules/rep_client/RepositoryBackendModule.php b/system/modules/rep_client/RepositoryBackendModule.php
index d04626c..ff8b0f4 100644
--- a/system/modules/rep_client/RepositoryBackendModule.php
+++ b/system/modules/rep_client/RepositoryBackendModule.php
@@ -124,7 +124,7 @@ class RepositoryBackendModule extends BackendModule
$proxy_uri = parse_url($GLOBALS['TL_CONFIG']['proxy_url']);
$this->client = new SoapClient($wsdl, array(
'soap_version' => SOAP_1_2,
- 'compression' => SOAP_COMPRESSION_ACCEPT | SOAP_COMPRESSION_GZIP | 1,
+ 'compression' => SOAP_COMPRESSION_ACCEPT | SOAP_COMPRESSION_GZIP,
'proxy_host' => $proxy_uri['host'],
'proxy_port' => $proxy_uri['port'],
'proxy_login' => $proxy_uri['user'],
@@ -135,7 +135,7 @@ class RepositoryBackendModule extends BackendModule
else {
$this->client = new SoapClient($wsdl, array(
'soap_version' => SOAP_1_2,
- 'compression' => SOAP_COMPRESSION_ACCEPT | SOAP_COMPRESSION_GZIP | 1
+ 'compression' => SOAP_COMPRESSION_ACCEPT | SOAP_COMPRESSION_GZIP
));
}
$this->mode = 'soap';</source>

Bei älteren Uberspaces, die vor dem Erscheinen der neuen PHP-Version erstellt worden sind, wird PHP 5.4 noch nicht automatisch aktiviert, dort müssen diese Änderungen nicht vorgenommen werden.

Bei neueren Uberspaces ist es außerdem möglich, wenn es sein muss, auf eine ältere PHP-Version (beispielsweise 5.3) umzuschalten. Dies ist [https://uberspace.de/dokuwiki/development:php#php-version_einstellen hier] beschrieben.

==WebhostOne==
[http://www.contao.org/neuigkeiten/items/typolight-als-1click-installation.html 1 Klick Installation von TL] Man kann bei speziellen Wünschen httpd.conf und php.ini selbst anpassen. Wenn man sich nicht so gut damit auskennt, kann man sogar im kostenlosen SupportChat fragen, wie man welchen Befehl schreiben muss.
==World4You==
Live Update URL ev. vom Support freischalten lassen. Contao als Easy-Install im Kundencenter verfügbar.

Datei:Check plan de.jpg

2014-07-27T16:19:52Z

BugBuster: BugBuster lud eine neue Version von „Datei:Check plan de.jpg“ hoch

Check Plan

Datei:Check overview de.jpg

2014-07-27T16:15:44Z

BugBuster: BugBuster lud eine neue Version von „Datei:Check overview de.jpg“ hoch

Check Übersicht

Integrity Check

2014-07-27T16:02:36Z

BugBuster: Update zur Version 3.4.0

[[File:check_overview_de.jpg|right|Integrity Check]] Früherkennung von gehackten Contao Installationen mittels Integritäts Check einiger Dateien.

{{ExtInfo
| Dev=Glen Langer ([[User:BugBuster|BugBuster]])
| DevSite=http://www.contao.glen-langer.de
| ExtVersion=1.3.10 / 3.4.0
| Version=ab 2.10.0
| ERLink=http://www.contao.org/de/extension-list/view/integrity_check.de.html
| TrackerLink=https://github.com/BugBuster1701/integrity_check/issues
| DonateLink=http://www.amazon.de/wishlist/26HHEJOU03G76
}}
[[en:Integrity_Check]]
[[Kategorie:Extensions]]

Wie es dazu kommen kann, und das dabei in den meisten Fällen nicht Contao selbst schuldig ist, kann hier nachgelesen werden: [[Contao gehackt|Contao gehackt]]
 Nun muss mal das natürlich noch selber merken, möglichst bevor Google die Seite sperrt.

=Forum=
Fragen zum Integrity Check Modul werden im Forum beantwortet: [https://www.contao-community.de/showthread.php?32762-Integrity-Check-im-ER Forum]
 
Fehler und Wünsche können im [https://github.com/BugBuster1701/integrity_check/issues Tracking System] gemeldet werden.

=Übersetzungen=
Übersetzungen können auf [https://www.transifex.com/projects/p/contao-integrity_check/ Transifex] durchgeführt werden.

=Installation=
Installation erfolgt über das Extension Repository im Backend der Contao Installation. 
Eine manuelle Installation ist möglich, dazu die ZIP Datei [http://www.contao.org/de/extension-list/view/integrity_check.de.html vom Extension Repository laden], entpacken und entsprechend übertragen. 
Dadurch sollte ein Verzeichnis /system/modules/integrity_check angelegt worden sein. 
Danach wie dabei üblich /contao/install.php aufrufen um ein eventuelles Update der Datenbank durchführen. (nur bei manueller Installation) 
Im System Menü erscheint dann ein neuer Unterpunkt: Integritäts-Check

=Installation als Update=
Ein Update erfolgt identisch der Installation.

=Infektionsbeispiele=
Wie sieht nun eine solcher Hack aus? 
Im den von mir betrachteten Fällen war es ein Anhang an die index.php der zur Ausführung kam, wenn die Seite nicht aus dem Server-Cache kam. 
Dieser sah in etwa so aus (gekürzt): 
<source lang="php">
#c3284d#
echo(gzinflate(base64_decode("ZZBNisMwDIX.......T7oD")));
#/c3284d#
</source>
oder:
<source lang="php">
#d47c75#
echo "<script type=\"text/javascript\" .....</script>";
#/d47c75#
</source>
Oder so (gekürzt): 
<source lang="javascript">
<script type="text/javascript">
function frmAdd() {
var ifrm = document.createElement('iframe');
....
};
window.onload = frmAdd;
</script>
</source>

==Seite auf der schwarzen Liste==
Reagiert man nicht schnell genug, und Google bekommt das mit, wird die Seite auf die schwarze Liste gesetzt. Browser wie Firefox nutzen diese, um vor dem Zugriff darauf zu warnen. Das sieht dann so aus: 
[[Datei:site_on_black_list.jpg]]

Was nun zu tun ist steht im Wiki Beitrag [[Contao_gehackt]]. 
Und im Google wieder zu überzeugen, man hat aufgeräumt, siehe diese [http://support.google.com/webmasters/bin/answer.py?hl=de&answer=163633 Google Support Seite] dazu.

=Funktion des Moduls=
In der jetzigen Version werden diese PHP Files prüft auf Veränderungen. 
Geprüft werden:
* index.php
* cron.php (ab Version 1.1.0)
* contao/index.php
* contao/main.php
* .htaccess (ab Version 3.1.0)

Optionale Warning Checks:
* Contao Update Prüfung (ab Version 3.4.0)
* Prüfung auf Installtool Login-Sperre (ab Version 3.4.0)

==Prüfzeitpunkt==
Dieser Test wird automatisch durchgeführt über den Contao-Cron Mechanismus, siehe dazu den Punkt [[Integrity_Check#Feinheiten|Feinheiten]].

==Erkennung==
Die Prüfung kann erfolgen auf 2 Arten:
* identisch zum offiziellem Contao Check Tool, d.h. über MD5 Checksummen. Es werden die Checksummen für Contao ab 2.10.0 zum Vergleich herangezogen bis zur jeweils freigegebenen Contao Version.
* per Zeitstempel (ab Version 1.1.0). Dazu werden bei der Installation der Erweiterung die Zeitstempel der Dateien erfasst. Diese können auch jederzeit erneuert werden.

==Information==
Im Backend kann unter System - System-Log nach dem Ergebnis geschaut werden. Normalerweise, wenn alles OK ist, taucht keine Meldung auf. Im moduleigenem Debug Modus erfolgt dann nur eine Meldung:
* Integritäts-Überprüfung der Dateien abgeschlossen.
Wenn Veränderungen entdeckt werden, dann erfolgt eine entsprechende Meldung je Datei die es betrifft:
* Integritäts-Status für Datei index.php ist: beschädigt [MD5]
** in dem Fall wurde per Checksumme MD5 geprüft.
* Integritäts-Status für Datei cron.php ist: beschädigt [Zeitstempel]
** in dem Fall wurde per Zeitstempel geprüft, ab Version 1.1.0 möglich.
Eine Information ist per System-Log und per Mail ist möglich, siehe dazu den Punkt [[Integrity_Check#Feinheiten|Feinheiten]].

=Feinheiten=
==Integritäts-Check anlegen==
Beim Anlegen des Integritäts-Checks muss ein Überprüfungsplan definiert werden. Hier kann für jede der zu prüfenden Dateien der Zeitpunkt, die Erkennung und die Aktion eingestellt werden. 

[[Datei:check_plan_de.jpg]]

 
Anschließend noch die Integritäts-Überprüfung aktivieren. 
Will man sehen welche Dateien geprüft wurden und somit ob überhaupt, kann der moduleigene Debug Modus eingeschaltet werden.

===Zeitpunkt===
* in Contao 2.10: täglich, wöchentlich, monatlich
* in Contao 2.11: stündlich, täglich, wöchentlich, monatlich
* in Contao 3.0: minütlich*, stündlich, täglich, wöchentlich, monatlich
*muss manuell aktiviert werden

===Erkennung===
Die Erkennung einer Veränderung der Datei ist auf zwei Arten möglich:
* über eine MD5 Checksumme
* über einen Zeitstempel

===Aktion===
* System-Log: Nachricht erfolgt im System-Log, im Backend einsehbar
* Mail an Admin: eine Mail an den Admin der Contao Installation erfolgt
** Es erfolgt dann auch automatisch ein Eintrag im System-Log (ab Version 1.1.0)

==Hinweise==
===System-Log und Mail===
Ab Version 1.1.0 erfolgt automatisch ein Eintrag im System-Log, wenn eine Mail versendet wird. 
Möchte man in Verison 1.0.0 für eine Datei beide Arten der Information haben, legt man einfach im Plan die Überprüfung zweimal an mit je einem der Aktionen: 

[[Datei:check_plan_2_de.jpg]]
 
Hier als Beispiel nur für die index.php, dass geht natürlich auch für die anderen Dateien.

===Es kann nur einen geben!===
Es ist möglich in der Integritäts-Check Übersicht mehrere Checks anzulegen. Das macht im Prinzip aber keinen Sinn. Daher wird dafür gesorgt, dass es nur einen Integritäts-Check geben kann, der aktiv geschaltet ist. Schaltet man einen neuen aktiv, werden automatisch alle anderen vorhandenen inaktiv geschaltet.

==Schutz gegen Infektion==
Nun, ein genereller Schutz ist wohl nicht möglich. Wenn die Infektion z.B. dadurch passierte, dass jemand an die FTP Daten kam, kann er alles was der Eigentümer auch kann. 
Es gibt aber eine Möglichkeit, dass der angehangene Code nicht zur Ausführung kommt. In Contao 3 wurde dies bereits auf ähnliche Art umgesetzt. Hier mal kurz die Info für Contao 2. 
Editiert die index.php und geht in die letzte Zeile der Methode "run", müsste die Zeile 269 sein. (2.11.5) Schreibt davor einfach ein '''''exit;''''' rein, oder fügt eine Zeile dafür ein. Hier mal ab Zeile 268 als Beispiel:
<source lang="php">
}
}
</source>
wird zu:
<source lang="php">
}
exit;
}
</source>
Damit wird die Abarbeitung des Scripte beendet, was auch OK ist, da davor die Seite bereits zum Browser gesendet wurde.
Achtung: Nun wird das Integrity Check Tool wie auch das Contao Check Tool eine Veränderung melden im MD5 Checksummen Test. Ab Version 1.1.0 kann in dem Fall dann der Test per Zeitstempel ausgewählt werden.

----
--[[Benutzer:BugBuster|BugBuster]] ([[Benutzer Diskussion:BugBuster|Diskussion]]) 18:02, 27. Jul. 2014 (CEST)

Transifex – Lokalisierungsplattform

2014-07-07T20:40:48Z

BugBuster:

[[Category:Transifex]]
[[Category:Dev_HOWTOS]]
[[Category:Development]]
[[Category:Extensions]]
[https://www.transifex.com Transifex] ist ein Lokalisierungs-Workflow und eine Crowdsourcing-Plattform, geeignet für die Übersetzung von Software.

Contao nutzt ab Version 3.0 diese Plattform auf Basis von XLIFF Dateien, diese können ab Contao 3.1 auch direkt verarbeitet werden. 
[https://www.transifex.com/projects/p/contao/ Contao Projekt auf Transifex]

Auch für externe Erweiterungen ist dieser Service gut geeignet. Die Übersetzungen erfolgen dabei meist online, aber auch offline ist dieses möglich mit einem passenden XLIFF Editor.

Nachfolgende Seiten sollen zeigen wie [[#Transifex_f.C3.BCr_Entwickler|Entwickler]] und [[#Transifex_f.C3.BCr_.C3.9Cbersetzer|Übersetzer]] damit umgehen können.

=Begriffe=
Begriffe die einem über den Weg laufen bei der Nutzung von Transifex.

==Organisation==
Eine Organisation stellt in der Regel ein Unternehmen oder ein große Lokalisierungsprojekt da, wie zum Beispiel "Contao". Ein Unternehmen hat in der Regel eine Organisation und ist verbunden mit dieser. Diese beherbergt die Übersetzungsteams und verschiedene Projekte.

==Projekt==
Ein Art Container, in dem übersetzbaren Inhalte übertragen werden. Dieser Container kann ein Computerprogramm, eine Werbekampagne, Dokumente oder ähnliches sein. Eine Organisation kann beliebige viele Projekte haben (konstenlos nur bei Open Source)

==Ressource==
Dateien, die übersetzbaren Strings enthalten. Nachdem ein Projekt erstellt wurde, kann der Nutzer seine Ressourcen uploaden, die übersetzbaren Dateien in der entsprechenden Quellsprache. Eine Ressource kann die Dokumentation eines Computerprogramms darstellen, die Worte in einem Menü, usw. Ein Projekt kann so viele Ressourcen haben, wie gebraucht werden.

==Ursprungssprache==
Beim Anlegen des Projektes in Transifex legt man die Ursprungssprache fest. Sie dient als Basissprache für alle Übersetzer in andere Sprachen. Daher bietet es sich an englisch (en) als Ursprungssprache zu definieren.
{{Achtung|Die Ursprungssprache kann später nicht mehr geändert werden. Dazu muss das ganze Projekt gelöscht und neu angelegt werden.}}

=Nutzer Rollen=
Ein Nutzer kann eine oder mehrere Rollen übernehmen innerhalb der Organisation. Hobby Entwickler mit mehreren kleinen Erweiterungen werden in der Muttersprache alle Rollen übernehmen, in anderen Sprachen nur einige davon.

==Organisations-Administrator==
Administratoren sind Benutzer, die Zugang zu bestimmten Werkzeugen auf Transifex haben somit die volle Kontrolle über eine Organisation haben.

==Projekt-Betreuer==
Diese Nutzer haben die Kontrolle über die Einstellungen eines Projekts, wie Eigentum, Löschung, maschinelle Übersetzung, TMX-Dateien, Auto-Update usw.

==Sprachteam Koordinator==
Jedes Übersetzungsteam hat mindestens einen Sprachkoordinator. Er ist für die Lokalisierung in diese spezifische Sprache verantwortlich. Er kann Übersetzer und Prüfer freigeben und auch selbst übersetzen.

==Prüfer==
Ein Benutzer, der sowohl über Übersetzungs- und Überprüfungs-Berechtigungen verfügt. Er kann entweder übersetzen, eine Übersetzung bearbeiten oder eine Übersetzung markieren als überprüft, für die Qualitätskontrolle.

==Übersetzer==
Ein Benutzer mit Berechtigungen Übersetzung, der auch in Team-Diskussionen (auf Transifex) veröffentlichen kann. Übersetzer werden auf eine bestimmte Sprache gebunden, können aber auch als Prüfer definiert werden.

=Transifex für Entwickler=
Neben den TX Client von Transifex gibt es Dank der API auch diverse externe Tools. Eines davon soll hier vorgestellt und in der Nutzunug erläutert werden.

[[Transifex_mit_TX_Client|Nutzung Transifex mit dem TX Client]]

[[Transifex_mit_Contao_Toolbox|Nutzung Transifex mit Contao-Toolbox]]

=Transifex für Übersetzer=
Transifex ist als eine Onlineplattform zum Übersetzen konzipiert. Es ist aber auch offline, also lokal möglich die Ressourcen zu übersetzen und hoch zu laden.

[[Transifex_für_Übersetzer_Online|Transifex für Übersetzer Online]]

[[Transifex_für_Übersetzer_Offline|Transifex für Übersetzer Offline]]

----
--[[Benutzer:BugBuster|BugBuster]] ([[Benutzer Diskussion:BugBuster|Diskussion]]) 15:42, 30. Jun. 2014 (CEST)

Transifex für Übersetzer Offline

2014-07-07T20:37:25Z

BugBuster:

[[Category:Transifex]]
[[Category:Dev_HOWTOS]]
[[Category:Development]]
[[Category:Extensions]]
TODO: Folgt später.

<< [[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]

Transifex für Übersetzer Online

2014-07-07T20:37:01Z

BugBuster:

[[Category:Transifex]]
[[Category:Dev_HOWTOS]]
[[Category:Development]]
[[Category:Extensions]]
<< [[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]
=Registration in Transifex=
Wer nur als Übersetzer in Transifex arbeiten möchte, muss sich dort als erstes als Contributor registrieren.
* https://www.transifex.com/signup/contributor/
In der Bestätigungs-E-Mail auf den Bestätigungslink klicken.

=An einem Projekt beteiligen=
Es gibt nun zwei Wege sich an Übersetzungen zu beteiligen. 
Ein öffentliches Projekt suchen über https://www.transifex.com/connect/projects/ und dann:
* in der Sprachübersicht auf eine Sprache klicken und dort auf "Gruppe beitreten", um bei eine vorhandene Sprache mitzuwirken oder
* in der Sprachübersicht auf "Sprache anfragen", um eine neue Sprache für dieses Projekt zu öffen.

=Übersetzen einer Ressource=
Sobald man in die gewählte Sprachen wechseln kann, sieht man die Ressourcen. Diese anklicken, und dann in dem Popup auf "Jetzt übersetzen".
Nun sieht man ein Formular, links die einzelnen Wortgruppen der gewählten Ressource, in der Mitte das Original und die Übersetzung (bzw. leer), und rechts einige Statusinformation wie Vorschläge, Verlauf etc. (bei kleinerer Auflösung ist die rechte Spalte unter der mittleren)

Nun klickt man sich links die Wortgruppe raus die man übersetzen will, tut das in der Mitte und geht mit TAB zur nächsten, wobei vorher automatisch gespeichert wird, oder speichert direkt.

Ist man als Prüfer eingetragen, gibt es dort noch einen Button "Überprüfen". Damit markiert man dann, dass die Übersetzung von jemandem anderem stimmt und bestätigt wird.

Ist man mit dieser Ressource fertig, klickt man links oben auf den Ressourcen Name und bekommt eine Übersicht weiterer Ressourcen. So kann man sich durch alle Ressourcen durcharbeiten und die Wortgruppen übersetzen die man möchte. Man muss nicht alles übersetzen, ist natürlich gern gesehen, jede Kleinigkeit hilft.

<< [[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]

----
--[[Benutzer:BugBuster|BugBuster]] ([[Benutzer Diskussion:BugBuster|Diskussion]]) 16:04, 3. Jul. 2014 (CEST)

Transifex mit TX Client

2014-07-07T20:36:30Z

BugBuster:

[[Category:Transifex]]
[[Category:Dev_HOWTOS]]
[[Category:Development]]
[[Category:Extensions]]
TODO: Folgt später.
{{stub}}
<< [[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]

Transifex – Lokalisierungsplattform

2014-07-07T20:36:13Z

BugBuster:

[[Category:Transifex]]
[[Category:Dev_HOWTOS]]
[[Category:Development]]
[[Category:Extensions]]
[https://www.transifex.com Transifex] ist ein Lokalisierungs-Workflow und eine Crowdsourcing-Plattform, geeignet für die Übersetzung von Software.

Contao nutzt ab Version 3.0 diese Plattform auf Basis von XLIFF Dateien, diese können ab Contao 3.1 auch direkt verarbeitet werden. 
[https://www.transifex.com/projects/p/contao/ Contao Projekt auf Transifex]

Auch für externe Erweiterungen ist dieser Service gut geeignet. Die Übersetzungen erfolgen dabei meist online, aber auch offline ist dieses möglich mit einem passenden XLIFF Editor.

Nachfolgende Seiten sollen zeigen wie Entwickler und Übersetzer damit umgehen können.

=Begriffe=
Begriffe die einem über den Weg laufen bei der Nutzung von Transifex.

==Organisation==
Eine Organisation stellt in der Regel ein Unternehmen oder ein große Lokalisierungsprojekt da, wie zum Beispiel "Contao". Ein Unternehmen hat in der Regel eine Organisation und ist verbunden mit dieser. Diese beherbergt die Übersetzungsteams und verschiedene Projekte.

==Projekt==
Ein Art Container, in dem übersetzbaren Inhalte übertragen werden. Dieser Container kann ein Computerprogramm, eine Werbekampagne, Dokumente oder ähnliches sein. Eine Organisation kann beliebige viele Projekte haben (konstenlos nur bei Open Source)

==Ressource==
Dateien, die übersetzbaren Strings enthalten. Nachdem ein Projekt erstellt wurde, kann der Nutzer seine Ressourcen uploaden, die übersetzbaren Dateien in der entsprechenden Quellsprache. Eine Ressource kann die Dokumentation eines Computerprogramms darstellen, die Worte in einem Menü, usw. Ein Projekt kann so viele Ressourcen haben, wie gebraucht werden.

==Ursprungssprache==
Beim Anlegen des Projektes in Transifex legt man die Ursprungssprache fest. Sie dient als Basissprache für alle Übersetzer in andere Sprachen. Daher bietet es sich an englisch (en) als Ursprungssprache zu definieren.
{{Achtung|Die Ursprungssprache kann später nicht mehr geändert werden. Dazu muss das ganze Projekt gelöscht und neu angelegt werden.}}

=Nutzer Rollen=
Ein Nutzer kann eine oder mehrere Rollen übernehmen innerhalb der Organisation. Hobby Entwickler mit mehreren kleinen Erweiterungen werden in der Muttersprache alle Rollen übernehmen, in anderen Sprachen nur einige davon.

==Organisations-Administrator==
Administratoren sind Benutzer, die Zugang zu bestimmten Werkzeugen auf Transifex haben somit die volle Kontrolle über eine Organisation haben.

==Projekt-Betreuer==
Diese Nutzer haben die Kontrolle über die Einstellungen eines Projekts, wie Eigentum, Löschung, maschinelle Übersetzung, TMX-Dateien, Auto-Update usw.

==Sprachteam Koordinator==
Jedes Übersetzungsteam hat mindestens einen Sprachkoordinator. Er ist für die Lokalisierung in diese spezifische Sprache verantwortlich. Er kann Übersetzer und Prüfer freigeben und auch selbst übersetzen.

==Prüfer==
Ein Benutzer, der sowohl über Übersetzungs- und Überprüfungs-Berechtigungen verfügt. Er kann entweder übersetzen, eine Übersetzung bearbeiten oder eine Übersetzung markieren als überprüft, für die Qualitätskontrolle.

==Übersetzer==
Ein Benutzer mit Berechtigungen Übersetzung, der auch in Team-Diskussionen (auf Transifex) veröffentlichen kann. Übersetzer werden auf eine bestimmte Sprache gebunden, können aber auch als Prüfer definiert werden.

=Transifex für Entwickler=
Neben den TX Client von Transifex gibt es Dank der API auch diverse externe Tools. Eines davon soll hier vorgestellt und in der Nutzunug erläutert werden.

[[Transifex_mit_TX_Client|Nutzung Transifex mit dem TX Client]]

[[Transifex_mit_Contao_Toolbox|Nutzung Transifex mit Contao-Toolbox]]

=Transifex für Übersetzer=
Transifex ist als eine Onlineplattform zum Übersetzen konzipiert. Es ist aber auch offline, also lokal möglich die Ressourcen zu übersetzen und hoch zu laden.

[[Transifex_für_Übersetzer_Online|Transifex für Übersetzer Online]]

[[Transifex_für_Übersetzer_Offline|Transifex für Übersetzer Offline]]

----
--[[Benutzer:BugBuster|BugBuster]] ([[Benutzer Diskussion:BugBuster|Diskussion]]) 15:42, 30. Jun. 2014 (CEST)

Transifex mit Contao Toolbox

2014-07-07T20:35:08Z

BugBuster:

[[Category:Transifex]]
[[Category:Dev_HOWTOS]]
[[Category:Development]]
[[Category:Extensions]]
<< [[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]
=Was ist das?=
Die Contao-Toolbox, kurz '''ctb''', gibt es auf GitHub: [https://github.com/cyberspectrum/contao-toolbox contao-toolbox] 
Das Konzept dahinter ist folgender.
* der Entwickler legt wie bisher PHP Sprachdateien an für die Ursprungsprache, z.B. "en", im Modul Unterverzeichnis language/en/
* mit ''ctb'' werden alle Sprachdateien in das XLIFF Format gewandelt
* anschließend werden die XLIFF Dateien der Ursprungsprache (default: en) mit ''ctb'' hoch geladen nach Transifex und tauchen dadurch in der Ursprungsprache als Ressourcen auf
* übersetzte Ressourcen anderer Sprachen werden mit ''ctb'' runter geladen im XLIFF Format
* anschließend werden mit ''ctb'' diese in PHP Sprachdateien umgewandelt und in das passende Verzeichnis abgelegt, z.B. language/de/

=Installation=
Die Installationanleitung entspricht der aus der Readme von ctb und kann auf zwei Arten erfolgen.
==Über composer==
Download composer wenn noch nicht vorhanden:
<source lang="bash">
curl -sS https://getcomposer.org/installer | php
</source>
Und nun die Contao Toolbox installieren:
<source lang="bash">
php composer create-project --prefer-source cyberspectrum/contao-toolbox
</source>
{{Achtung|Am Ende der Installation wird gefragt, ob die VCS History gelöscht werden kann, hier mit 'n' dieses verneinen. Sonst arbeitet der Compiler nicht richtig (folgt später)}}
<source lang="bash">
Do you want to remove the existing VCS (.git, .svn..) history? [Y,n]? n
</source>

==Über Git Cloning==
<source lang="bash">
git clone https://github.com/discordier/contao-toolbox.git
</source>
Anschließend als erstes die Abhängigkeiten auflösen.
<source lang="bash">
php composer update
</source>
Um nun die ctb von überall aufrufen zu können, diese liegt ja nicht im Suchpfad, habe ich dazu noch ein Alias angelegt. Pfad in diesem Beispiel muss jeder für sich anpassen:
<source lang="bash">
alias ctb='/contao_entwicklung/contao-toolbox/bin/ctb'
</source>
===Optional: eine ctb.phar kompilieren===
Zum kompilieren ruft man das mitgelieferten Compiler-Script auf.
<source lang="bash">
./bin/compile-ctb
</source>
Diese phar Datei kann man nun in ein Pfad kopieren auf dem ein Suchpfad liegt. Dadurch ist die spätere Nutzung einfacher. Dazu noch ein symbolischen Link anlegen, um ''ctb'' ohne die Endung .phar aufrufen zu können.
<source lang="bash">
ln -s ctb.phar ctb
</source>
Falls es zu einem Compiler Fehler kommt liegt es wohl an einer Einstellungen in der php.ini, dort muss definiert sein:
<source lang="ini">
[Phar]
phar.readonly = Off
</source>
Weitere Hinweise dazu: [http://php.net/phar.readonly php.net/phar.readonly] 

Wo die php.ini der PHP Kommandozeilenversion liegt, erfährt man so:
<source lang="bash">
php --ini | grep 'Configuration File'
</source>

=Konfiguration=
Um bei der Nutzung nicht immer Login und Passwort angeben zu müssen, kann man diese in seine Home-Verzeichnis in einer Konfigurationsdatei im json-Format anlegen wie folgt: <pre>`$HOME/.config/ctb/config.json`</pre>
<source lang="xml">
{
"transifex": {
"user": "john-doe",
"pass": "sUp3rPassword!"
}
}
</source>
In der composer.json der jeweiligen Erweiterung kann man ebenfalls einige Daten ablagen um die Aufrufe auf Kommandozeile zu verkürzen.
Dazu den Abschnitt extra ergänzen:
<source lang="xml">
{
"extra":{
"contao": {
"transifex": {
"project": "acme-core",
"prefix": "core-",
"languages_cto": "languages",
"languages_tx": ".tx"
}
}
}
}
</source>
Dabei bedeuten:
* "project" : der Projektname auf Transifex
* "prefix" : ein frei wählbarer Prefix, aus diesem und dem originalem Dateiname wird der Dateiname für die Ressource generiert (z.B.: core-tl_module)
* "languages_cto": Verzeichnisname in dem die Sprachunterverzeichnisse liegen (/de/..., /en/... )
* "languages_tx": Verzeichnisname in der die umgewandelten XLIFF Datein abgelegt werden sollen

Mit dem "prefix" wäre es z.B. möglich, die Sprachdateien von mehreren Teilprojekten innerhalb eines einzigen transifex Projektes zu speichern.

=Kommandozeilen Workflow=
Im Hauptverzeichnis seiner Erweiterung ruft man nun die einzelnen Jobs auf die zu erledigen sind. Dabei wird von den obigen Definitionen ausgegangen.
Das ''--verbose'' dient hier nur zu Kontrolle, was gerade durchgeführt wird. Die ''--base-language'' könnte weggelassen werden, "en" ist hier das default.

==Sprachfiles in xliff umwandeln in Verzeichnis .tx==
<source lang="bash">
ctb to-xliff --base-language="en" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb to-xliff --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --verbose
</source>

==Urpsungssprache hochladen zu Transifex==
<source lang="bash">
ctb upload-transifex --base-language="en" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb upload-transifex --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --verbose
</source>

==Übersetzen in Transifex==
Zu diesem Zeitpunkt würde nun die Online-Übersetzung auf Transifex erfolgen. Liegen bereits weitere Sprachen vor, z.B. aus ER2 Zeiten, können diese manuell hochgeladen werden, dazu später. ('''ctb''' kann dieses derzeit nicht)

==Übersetze Sprachen von Transifex laden==
<source lang="bash">
ctb download-transifex --base-language="en" --mode="translated" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb download-transifex --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --mode="translated" --verbose
</source>
Hier wurde der default Wert vom Modus "reviewed" auf "translated" geändert. Damit bekommt man alle übersetzte Sprachen, egal wieviel Prozent davon fertig sind.

==Sprachfiles in PHP umwandeln und in die Sprachverzeichnisse ablegen==
<source lang="bash">
ctb from-xliff --base-language="en" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb from-xliff --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --verbose
</source>
Dabei werden die vorhandenen nur überschrieben, wenn Änderungen vorliegen.

=Upload weiterer Sprachen=

TODO: Wird ergänzt.

<< [[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]

Transifex mit Contao Toolbox

2014-07-07T20:33:03Z

BugBuster: /* Optional: eine ctb.phar kompilieren */

[[Kategorie:Transifex]]
<< [[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]
=Was ist das?=
Die Contao-Toolbox, kurz '''ctb''', gibt es auf GitHub: [https://github.com/cyberspectrum/contao-toolbox contao-toolbox] 
Das Konzept dahinter ist folgender.
* der Entwickler legt wie bisher PHP Sprachdateien an für die Ursprungsprache, z.B. "en", im Modul Unterverzeichnis language/en/
* mit ''ctb'' werden alle Sprachdateien in das XLIFF Format gewandelt
* anschließend werden die XLIFF Dateien der Ursprungsprache (default: en) mit ''ctb'' hoch geladen nach Transifex und tauchen dadurch in der Ursprungsprache als Ressourcen auf
* übersetzte Ressourcen anderer Sprachen werden mit ''ctb'' runter geladen im XLIFF Format
* anschließend werden mit ''ctb'' diese in PHP Sprachdateien umgewandelt und in das passende Verzeichnis abgelegt, z.B. language/de/

=Installation=
Die Installationanleitung entspricht der aus der Readme von ctb und kann auf zwei Arten erfolgen.
==Über composer==
Download composer wenn noch nicht vorhanden:
<source lang="bash">
curl -sS https://getcomposer.org/installer | php
</source>
Und nun die Contao Toolbox installieren:
<source lang="bash">
php composer create-project --prefer-source cyberspectrum/contao-toolbox
</source>
{{Achtung|Am Ende der Installation wird gefragt, ob die VCS History gelöscht werden kann, hier mit 'n' dieses verneinen. Sonst arbeitet der Compiler nicht richtig (folgt später)}}
<source lang="bash">
Do you want to remove the existing VCS (.git, .svn..) history? [Y,n]? n
</source>

==Über Git Cloning==
<source lang="bash">
git clone https://github.com/discordier/contao-toolbox.git
</source>
Anschließend als erstes die Abhängigkeiten auflösen.
<source lang="bash">
php composer update
</source>
Um nun die ctb von überall aufrufen zu können, diese liegt ja nicht im Suchpfad, habe ich dazu noch ein Alias angelegt. Pfad in diesem Beispiel muss jeder für sich anpassen:
<source lang="bash">
alias ctb='/contao_entwicklung/contao-toolbox/bin/ctb'
</source>
===Optional: eine ctb.phar kompilieren===
Zum kompilieren ruft man das mitgelieferten Compiler-Script auf.
<source lang="bash">
./bin/compile-ctb
</source>
Diese phar Datei kann man nun in ein Pfad kopieren auf dem ein Suchpfad liegt. Dadurch ist die spätere Nutzung einfacher. Dazu noch ein symbolischen Link anlegen, um ''ctb'' ohne die Endung .phar aufrufen zu können.
<source lang="bash">
ln -s ctb.phar ctb
</source>
Falls es zu einem Compiler Fehler kommt liegt es wohl an einer Einstellungen in der php.ini, dort muss definiert sein:
<source lang="ini">
[Phar]
phar.readonly = Off
</source>
Weitere Hinweise dazu: [http://php.net/phar.readonly php.net/phar.readonly] 

Wo die php.ini der PHP Kommandozeilenversion liegt, erfährt man so:
<source lang="bash">
php --ini | grep 'Configuration File'
</source>

=Konfiguration=
Um bei der Nutzung nicht immer Login und Passwort angeben zu müssen, kann man diese in seine Home-Verzeichnis in einer Konfigurationsdatei im json-Format anlegen wie folgt: <pre>`$HOME/.config/ctb/config.json`</pre>
<source lang="xml">
{
"transifex": {
"user": "john-doe",
"pass": "sUp3rPassword!"
}
}
</source>
In der composer.json der jeweiligen Erweiterung kann man ebenfalls einige Daten ablagen um die Aufrufe auf Kommandozeile zu verkürzen.
Dazu den Abschnitt extra ergänzen:
<source lang="xml">
{
"extra":{
"contao": {
"transifex": {
"project": "acme-core",
"prefix": "core-",
"languages_cto": "languages",
"languages_tx": ".tx"
}
}
}
}
</source>
Dabei bedeuten:
* "project" : der Projektname auf Transifex
* "prefix" : ein frei wählbarer Prefix, aus diesem und dem originalem Dateiname wird der Dateiname für die Ressource generiert (z.B.: core-tl_module)
* "languages_cto": Verzeichnisname in dem die Sprachunterverzeichnisse liegen (/de/..., /en/... )
* "languages_tx": Verzeichnisname in der die umgewandelten XLIFF Datein abgelegt werden sollen

Mit dem "prefix" wäre es z.B. möglich, die Sprachdateien von mehreren Teilprojekten innerhalb eines einzigen transifex Projektes zu speichern.

=Kommandozeilen Workflow=
Im Hauptverzeichnis seiner Erweiterung ruft man nun die einzelnen Jobs auf die zu erledigen sind. Dabei wird von den obigen Definitionen ausgegangen.
Das ''--verbose'' dient hier nur zu Kontrolle, was gerade durchgeführt wird. Die ''--base-language'' könnte weggelassen werden, "en" ist hier das default.

==Sprachfiles in xliff umwandeln in Verzeichnis .tx==
<source lang="bash">
ctb to-xliff --base-language="en" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb to-xliff --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --verbose
</source>

==Urpsungssprache hochladen zu Transifex==
<source lang="bash">
ctb upload-transifex --base-language="en" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb upload-transifex --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --verbose
</source>

==Übersetzen in Transifex==
Zu diesem Zeitpunkt würde nun die Online-Übersetzung auf Transifex erfolgen. Liegen bereits weitere Sprachen vor, z.B. aus ER2 Zeiten, können diese manuell hochgeladen werden, dazu später. ('''ctb''' kann dieses derzeit nicht)

==Übersetze Sprachen von Transifex laden==
<source lang="bash">
ctb download-transifex --base-language="en" --mode="translated" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb download-transifex --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --mode="translated" --verbose
</source>
Hier wurde der default Wert vom Modus "reviewed" auf "translated" geändert. Damit bekommt man alle übersetzte Sprachen, egal wieviel Prozent davon fertig sind.

==Sprachfiles in PHP umwandeln und in die Sprachverzeichnisse ablegen==
<source lang="bash">
ctb from-xliff --base-language="en" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb from-xliff --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --verbose
</source>
Dabei werden die vorhandenen nur überschrieben, wenn Änderungen vorliegen.

=Upload weiterer Sprachen=

TODO: Wird ergänzt.

<< [[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]

Transifex mit Contao Toolbox

2014-07-07T20:26:06Z

BugBuster: /* Optional: eine ctb.phar kompilieren */

[[Kategorie:Transifex]]
<< [[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]
=Was ist das?=
Die Contao-Toolbox, kurz '''ctb''', gibt es auf GitHub: [https://github.com/cyberspectrum/contao-toolbox contao-toolbox] 
Das Konzept dahinter ist folgender.
* der Entwickler legt wie bisher PHP Sprachdateien an für die Ursprungsprache, z.B. "en", im Modul Unterverzeichnis language/en/
* mit ''ctb'' werden alle Sprachdateien in das XLIFF Format gewandelt
* anschließend werden die XLIFF Dateien der Ursprungsprache (default: en) mit ''ctb'' hoch geladen nach Transifex und tauchen dadurch in der Ursprungsprache als Ressourcen auf
* übersetzte Ressourcen anderer Sprachen werden mit ''ctb'' runter geladen im XLIFF Format
* anschließend werden mit ''ctb'' diese in PHP Sprachdateien umgewandelt und in das passende Verzeichnis abgelegt, z.B. language/de/

=Installation=
Die Installationanleitung entspricht der aus der Readme von ctb und kann auf zwei Arten erfolgen.
==Über composer==
Download composer wenn noch nicht vorhanden:
<source lang="bash">
curl -sS https://getcomposer.org/installer | php
</source>
Und nun die Contao Toolbox installieren:
<source lang="bash">
php composer create-project --prefer-source cyberspectrum/contao-toolbox
</source>
{{Achtung|Am Ende der Installation wird gefragt, ob die VCS History gelöscht werden kann, hier mit 'n' dieses verneinen. Sonst arbeitet der Compiler nicht richtig (folgt später)}}
<source lang="bash">
Do you want to remove the existing VCS (.git, .svn..) history? [Y,n]? n
</source>

==Über Git Cloning==
<source lang="bash">
git clone https://github.com/discordier/contao-toolbox.git
</source>
Anschließend als erstes die Abhängigkeiten auflösen.
<source lang="bash">
php composer update
</source>
Um nun die ctb von überall aufrufen zu können, diese liegt ja nicht im Suchpfad, habe ich dazu noch ein Alias angelegt. Pfad in diesem Beispiel muss jeder für sich anpassen:
<source lang="bash">
alias ctb='/contao_entwicklung/contao-toolbox/bin/ctb'
</source>
===Optional: eine ctb.phar kompilieren===
Zum kompilieren ruft man das mitgelieferten Compiler-Script auf.
<source lang="bash">
./bin/compile-ctb
</source>
Diese phar Datei kann man nun in ein Pfad kopieren auf dem ein Suchpfad liegt. Dadurch ist die spätere Nutzung einfacher. Dazu noch ein symbolischen Link anlegen, um ''ctb'' ohne die Endung .phar aufrufen zu können.
<source lang="bash">
ln -s ctb.phar ctb
</source>
Falls es zu einem Compiler Fehler kommt liegt es wohl an einer Einstellungen in der php.ini, dort muss definiert sein:
<source lang="ini">
[Phar]
phar.readonly = Off
</source>
Weitere Hinweise dazu: [http://php.net/phar.readonly php.net/phar.readonly] 

Wo die php.ini der PHP Kommandozeilenversion liegt, erfährt man so:
<source lang="bash">
php -i | grep 'Configuration File'
</source>

=Konfiguration=
Um bei der Nutzung nicht immer Login und Passwort angeben zu müssen, kann man diese in seine Home-Verzeichnis in einer Konfigurationsdatei im json-Format anlegen wie folgt: <pre>`$HOME/.config/ctb/config.json`</pre>
<source lang="xml">
{
"transifex": {
"user": "john-doe",
"pass": "sUp3rPassword!"
}
}
</source>
In der composer.json der jeweiligen Erweiterung kann man ebenfalls einige Daten ablagen um die Aufrufe auf Kommandozeile zu verkürzen.
Dazu den Abschnitt extra ergänzen:
<source lang="xml">
{
"extra":{
"contao": {
"transifex": {
"project": "acme-core",
"prefix": "core-",
"languages_cto": "languages",
"languages_tx": ".tx"
}
}
}
}
</source>
Dabei bedeuten:
* "project" : der Projektname auf Transifex
* "prefix" : ein frei wählbarer Prefix, aus diesem und dem originalem Dateiname wird der Dateiname für die Ressource generiert (z.B.: core-tl_module)
* "languages_cto": Verzeichnisname in dem die Sprachunterverzeichnisse liegen (/de/..., /en/... )
* "languages_tx": Verzeichnisname in der die umgewandelten XLIFF Datein abgelegt werden sollen

Mit dem "prefix" wäre es z.B. möglich, die Sprachdateien von mehreren Teilprojekten innerhalb eines einzigen transifex Projektes zu speichern.

=Kommandozeilen Workflow=
Im Hauptverzeichnis seiner Erweiterung ruft man nun die einzelnen Jobs auf die zu erledigen sind. Dabei wird von den obigen Definitionen ausgegangen.
Das ''--verbose'' dient hier nur zu Kontrolle, was gerade durchgeführt wird. Die ''--base-language'' könnte weggelassen werden, "en" ist hier das default.

==Sprachfiles in xliff umwandeln in Verzeichnis .tx==
<source lang="bash">
ctb to-xliff --base-language="en" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb to-xliff --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --verbose
</source>

==Urpsungssprache hochladen zu Transifex==
<source lang="bash">
ctb upload-transifex --base-language="en" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb upload-transifex --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --verbose
</source>

==Übersetzen in Transifex==
Zu diesem Zeitpunkt würde nun die Online-Übersetzung auf Transifex erfolgen. Liegen bereits weitere Sprachen vor, z.B. aus ER2 Zeiten, können diese manuell hochgeladen werden, dazu später. ('''ctb''' kann dieses derzeit nicht)

==Übersetze Sprachen von Transifex laden==
<source lang="bash">
ctb download-transifex --base-language="en" --mode="translated" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb download-transifex --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --mode="translated" --verbose
</source>
Hier wurde der default Wert vom Modus "reviewed" auf "translated" geändert. Damit bekommt man alle übersetzte Sprachen, egal wieviel Prozent davon fertig sind.

==Sprachfiles in PHP umwandeln und in die Sprachverzeichnisse ablegen==
<source lang="bash">
ctb from-xliff --base-language="en" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb from-xliff --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --verbose
</source>
Dabei werden die vorhandenen nur überschrieben, wenn Änderungen vorliegen.

=Upload weiterer Sprachen=

TODO: Wird ergänzt.

<< [[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]

Transifex mit Contao Toolbox

2014-07-07T20:17:52Z

BugBuster: /* Über Git Cloning */

[[Kategorie:Transifex]]
<< [[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]
=Was ist das?=
Die Contao-Toolbox, kurz '''ctb''', gibt es auf GitHub: [https://github.com/cyberspectrum/contao-toolbox contao-toolbox] 
Das Konzept dahinter ist folgender.
* der Entwickler legt wie bisher PHP Sprachdateien an für die Ursprungsprache, z.B. "en", im Modul Unterverzeichnis language/en/
* mit ''ctb'' werden alle Sprachdateien in das XLIFF Format gewandelt
* anschließend werden die XLIFF Dateien der Ursprungsprache (default: en) mit ''ctb'' hoch geladen nach Transifex und tauchen dadurch in der Ursprungsprache als Ressourcen auf
* übersetzte Ressourcen anderer Sprachen werden mit ''ctb'' runter geladen im XLIFF Format
* anschließend werden mit ''ctb'' diese in PHP Sprachdateien umgewandelt und in das passende Verzeichnis abgelegt, z.B. language/de/

=Installation=
Die Installationanleitung entspricht der aus der Readme von ctb und kann auf zwei Arten erfolgen.
==Über composer==
Download composer wenn noch nicht vorhanden:
<source lang="bash">
curl -sS https://getcomposer.org/installer | php
</source>
Und nun die Contao Toolbox installieren:
<source lang="bash">
php composer create-project --prefer-source cyberspectrum/contao-toolbox
</source>
{{Achtung|Am Ende der Installation wird gefragt, ob die VCS History gelöscht werden kann, hier mit 'n' dieses verneinen. Sonst arbeitet der Compiler nicht richtig (folgt später)}}
<source lang="bash">
Do you want to remove the existing VCS (.git, .svn..) history? [Y,n]? n
</source>

==Über Git Cloning==
<source lang="bash">
git clone https://github.com/discordier/contao-toolbox.git
</source>
Anschließend als erstes die Abhängigkeiten auflösen.
<source lang="bash">
php composer update
</source>
Um nun die ctb von überall aufrufen zu können, diese liegt ja nicht im Suchpfad, habe ich dazu noch ein Alias angelegt. Pfad in diesem Beispiel muss jeder für sich anpassen:
<source lang="bash">
alias ctb='/contao_entwicklung/contao-toolbox/bin/ctb'
</source>
===Optional: eine ctb.phar kompilieren===
Zum kompilieren ruft man das mitgelieferten Compiler-Script auf.
<source lang="bash">
./bin/compile-ctb
</source>
Diese phar Datei kann man nun in ein Pfad kopieren auf dem ein Suchpfad liegt. Dadurch ist die spätere Nutzung einfacher. Dazu noch ein symbolischen Link anlegen, um ctb ohne die Endung .phar aufrufen zu können.
<source lang="bash">
ln -s ctb.phar ctb
</source>
Falls es zu einem Compiler Fehler kommt liegt es wohl an einer Einstellungen in der php.ini, dort muss definiert sein:
<source lang="ini">
[Phar]
phar.readonly = Off
</source>
Weitere Hinweise dazu: [http://php.net/phar.readonly php.net/phar.readonly]

=Konfiguration=
Um bei der Nutzung nicht immer Login und Passwort angeben zu müssen, kann man diese in seine Home-Verzeichnis in einer Konfigurationsdatei im json-Format anlegen wie folgt: <pre>`$HOME/.config/ctb/config.json`</pre>
<source lang="xml">
{
"transifex": {
"user": "john-doe",
"pass": "sUp3rPassword!"
}
}
</source>
In der composer.json der jeweiligen Erweiterung kann man ebenfalls einige Daten ablagen um die Aufrufe auf Kommandozeile zu verkürzen.
Dazu den Abschnitt extra ergänzen:
<source lang="xml">
{
"extra":{
"contao": {
"transifex": {
"project": "acme-core",
"prefix": "core-",
"languages_cto": "languages",
"languages_tx": ".tx"
}
}
}
}
</source>
Dabei bedeuten:
* "project" : der Projektname auf Transifex
* "prefix" : ein frei wählbarer Prefix, aus diesem und dem originalem Dateiname wird der Dateiname für die Ressource generiert (z.B.: core-tl_module)
* "languages_cto": Verzeichnisname in dem die Sprachunterverzeichnisse liegen (/de/..., /en/... )
* "languages_tx": Verzeichnisname in der die umgewandelten XLIFF Datein abgelegt werden sollen

Mit dem "prefix" wäre es z.B. möglich, die Sprachdateien von mehreren Teilprojekten innerhalb eines einzigen transifex Projektes zu speichern.

=Kommandozeilen Workflow=
Im Hauptverzeichnis seiner Erweiterung ruft man nun die einzelnen Jobs auf die zu erledigen sind. Dabei wird von den obigen Definitionen ausgegangen.
Das ''--verbose'' dient hier nur zu Kontrolle, was gerade durchgeführt wird. Die ''--base-language'' könnte weggelassen werden, "en" ist hier das default.

==Sprachfiles in xliff umwandeln in Verzeichnis .tx==
<source lang="bash">
ctb to-xliff --base-language="en" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb to-xliff --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --verbose
</source>

==Urpsungssprache hochladen zu Transifex==
<source lang="bash">
ctb upload-transifex --base-language="en" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb upload-transifex --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --verbose
</source>

==Übersetzen in Transifex==
Zu diesem Zeitpunkt würde nun die Online-Übersetzung auf Transifex erfolgen. Liegen bereits weitere Sprachen vor, z.B. aus ER2 Zeiten, können diese manuell hochgeladen werden, dazu später. ('''ctb''' kann dieses derzeit nicht)

==Übersetze Sprachen von Transifex laden==
<source lang="bash">
ctb download-transifex --base-language="en" --mode="translated" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb download-transifex --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --mode="translated" --verbose
</source>
Hier wurde der default Wert vom Modus "reviewed" auf "translated" geändert. Damit bekommt man alle übersetzte Sprachen, egal wieviel Prozent davon fertig sind.

==Sprachfiles in PHP umwandeln und in die Sprachverzeichnisse ablegen==
<source lang="bash">
ctb from-xliff --base-language="en" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb from-xliff --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --verbose
</source>
Dabei werden die vorhandenen nur überschrieben, wenn Änderungen vorliegen.

=Upload weiterer Sprachen=

TODO: Wird ergänzt.

<< [[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]

Transifex mit Contao Toolbox

2014-07-07T20:15:22Z

BugBuster: /* Konfiguration */

[[Kategorie:Transifex]]
<< [[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]
=Was ist das?=
Die Contao-Toolbox, kurz '''ctb''', gibt es auf GitHub: [https://github.com/cyberspectrum/contao-toolbox contao-toolbox] 
Das Konzept dahinter ist folgender.
* der Entwickler legt wie bisher PHP Sprachdateien an für die Ursprungsprache, z.B. "en", im Modul Unterverzeichnis language/en/
* mit ''ctb'' werden alle Sprachdateien in das XLIFF Format gewandelt
* anschließend werden die XLIFF Dateien der Ursprungsprache (default: en) mit ''ctb'' hoch geladen nach Transifex und tauchen dadurch in der Ursprungsprache als Ressourcen auf
* übersetzte Ressourcen anderer Sprachen werden mit ''ctb'' runter geladen im XLIFF Format
* anschließend werden mit ''ctb'' diese in PHP Sprachdateien umgewandelt und in das passende Verzeichnis abgelegt, z.B. language/de/

=Installation=
Die Installationanleitung entspricht der aus der Readme von ctb und kann auf zwei Arten erfolgen.
==Über composer==
Download composer wenn noch nicht vorhanden:
<source lang="bash">
curl -sS https://getcomposer.org/installer | php
</source>
Und nun die Contao Toolbox installieren:
<source lang="bash">
php composer create-project --prefer-source cyberspectrum/contao-toolbox
</source>
{{Achtung|Am Ende der Installation wird gefragt, ob die VCS History gelöscht werden kann, hier mit 'n' dieses verneinen. Sonst arbeitet der Compiler nicht richtig (folgt später)}}
<source lang="bash">
Do you want to remove the existing VCS (.git, .svn..) history? [Y,n]? n
</source>

==Über Git Cloning==
<source lang="bash">
git clone https://github.com/discordier/contao-toolbox.git
</source>
Anschließend als erstes die Abhängigkeiten auflösen.
<source lang="bash">
php composer update
</source>
Um nun die ctb von überall aufrufen zu können, diese liegt ja nicht im Suchpfad, habe ich dazu noch ein Alias angelegt. Pfad in diesem Beispiel muss jeder für sich anpassen:
<source lang="bash">
alias ctb='/contao_entwicklung/contao-toolbox/bin/ctb
</source>
===Optional: eine ctb.phar kompilieren===
Zum kompilieren ruft man das mitgelieferten Compiler-Script auf.
<source lang="bash">
./bin/compile-ctb
</source>
Diese phar Datei kann man nun in ein Pfad kopieren auf dem ein Suchpfad liegt. Dadurch ist die spätere Nutzung einfacher. Dazu noch ein symbolischen Link anlegen, um ctb ohne die Endung .phar aufrufen zu können.
<source lang="bash">
ln -s ctb.phar ctb
</source>
Falls es zu einem Compiler Fehler kommt liegt es wohl an einer Einstellungen in der php.ini, dort muss definiert sein:
<source lang="ini">
[Phar]
phar.readonly = Off
</source>
Weitere Hinweise dazu: [http://php.net/phar.readonly php.net/phar.readonly]

=Konfiguration=
Um bei der Nutzung nicht immer Login und Passwort angeben zu müssen, kann man diese in seine Home-Verzeichnis in einer Konfigurationsdatei im json-Format anlegen wie folgt: <pre>`$HOME/.config/ctb/config.json`</pre>
<source lang="xml">
{
"transifex": {
"user": "john-doe",
"pass": "sUp3rPassword!"
}
}
</source>
In der composer.json der jeweiligen Erweiterung kann man ebenfalls einige Daten ablagen um die Aufrufe auf Kommandozeile zu verkürzen.
Dazu den Abschnitt extra ergänzen:
<source lang="xml">
{
"extra":{
"contao": {
"transifex": {
"project": "acme-core",
"prefix": "core-",
"languages_cto": "languages",
"languages_tx": ".tx"
}
}
}
}
</source>
Dabei bedeuten:
* "project" : der Projektname auf Transifex
* "prefix" : ein frei wählbarer Prefix, aus diesem und dem originalem Dateiname wird der Dateiname für die Ressource generiert (z.B.: core-tl_module)
* "languages_cto": Verzeichnisname in dem die Sprachunterverzeichnisse liegen (/de/..., /en/... )
* "languages_tx": Verzeichnisname in der die umgewandelten XLIFF Datein abgelegt werden sollen

Mit dem "prefix" wäre es z.B. möglich, die Sprachdateien von mehreren Teilprojekten innerhalb eines einzigen transifex Projektes zu speichern.

=Kommandozeilen Workflow=
Im Hauptverzeichnis seiner Erweiterung ruft man nun die einzelnen Jobs auf die zu erledigen sind. Dabei wird von den obigen Definitionen ausgegangen.
Das ''--verbose'' dient hier nur zu Kontrolle, was gerade durchgeführt wird. Die ''--base-language'' könnte weggelassen werden, "en" ist hier das default.

==Sprachfiles in xliff umwandeln in Verzeichnis .tx==
<source lang="bash">
ctb to-xliff --base-language="en" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb to-xliff --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --verbose
</source>

==Urpsungssprache hochladen zu Transifex==
<source lang="bash">
ctb upload-transifex --base-language="en" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb upload-transifex --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --verbose
</source>

==Übersetzen in Transifex==
Zu diesem Zeitpunkt würde nun die Online-Übersetzung auf Transifex erfolgen. Liegen bereits weitere Sprachen vor, z.B. aus ER2 Zeiten, können diese manuell hochgeladen werden, dazu später. ('''ctb''' kann dieses derzeit nicht)

==Übersetze Sprachen von Transifex laden==
<source lang="bash">
ctb download-transifex --base-language="en" --mode="translated" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb download-transifex --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --mode="translated" --verbose
</source>
Hier wurde der default Wert vom Modus "reviewed" auf "translated" geändert. Damit bekommt man alle übersetzte Sprachen, egal wieviel Prozent davon fertig sind.

==Sprachfiles in PHP umwandeln und in die Sprachverzeichnisse ablegen==
<source lang="bash">
ctb from-xliff --base-language="en" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb from-xliff --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --verbose
</source>
Dabei werden die vorhandenen nur überschrieben, wenn Änderungen vorliegen.

=Upload weiterer Sprachen=

TODO: Wird ergänzt.

<< [[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]

Transifex mit Contao Toolbox

2014-07-07T19:46:56Z

BugBuster: /* Über Git Cloning */

[[Kategorie:Transifex]]
<< [[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]
=Was ist das?=
Die Contao-Toolbox, kurz '''ctb''', gibt es auf GitHub: [https://github.com/cyberspectrum/contao-toolbox contao-toolbox] 
Das Konzept dahinter ist folgender.
* der Entwickler legt wie bisher PHP Sprachdateien an für die Ursprungsprache, z.B. "en", im Modul Unterverzeichnis language/en/
* mit ''ctb'' werden alle Sprachdateien in das XLIFF Format gewandelt
* anschließend werden die XLIFF Dateien der Ursprungsprache (default: en) mit ''ctb'' hoch geladen nach Transifex und tauchen dadurch in der Ursprungsprache als Ressourcen auf
* übersetzte Ressourcen anderer Sprachen werden mit ''ctb'' runter geladen im XLIFF Format
* anschließend werden mit ''ctb'' diese in PHP Sprachdateien umgewandelt und in das passende Verzeichnis abgelegt, z.B. language/de/

=Installation=
Die Installationanleitung entspricht der aus der Readme von ctb und kann auf zwei Arten erfolgen.
==Über composer==
Download composer wenn noch nicht vorhanden:
<source lang="bash">
curl -sS https://getcomposer.org/installer | php
</source>
Und nun die Contao Toolbox installieren:
<source lang="bash">
php composer create-project --prefer-source cyberspectrum/contao-toolbox
</source>
{{Achtung|Am Ende der Installation wird gefragt, ob die VCS History gelöscht werden kann, hier mit 'n' dieses verneinen. Sonst arbeitet der Compiler nicht richtig (folgt später)}}
<source lang="bash">
Do you want to remove the existing VCS (.git, .svn..) history? [Y,n]? n
</source>

==Über Git Cloning==
<source lang="bash">
git clone https://github.com/discordier/contao-toolbox.git
</source>
Anschließend als erstes die Abhängigkeiten auflösen.
<source lang="bash">
php composer update
</source>
Um nun die ctb von überall aufrufen zu können, diese liegt ja nicht im Suchpfad, habe ich dazu noch ein Alias angelegt. Pfad in diesem Beispiel muss jeder für sich anpassen:
<source lang="bash">
alias ctb='/contao_entwicklung/contao-toolbox/bin/ctb
</source>
===Optional: eine ctb.phar kompilieren===
Zum kompilieren ruft man das mitgelieferten Compiler-Script auf.
<source lang="bash">
./bin/compile-ctb
</source>
Diese phar Datei kann man nun in ein Pfad kopieren auf dem ein Suchpfad liegt. Dadurch ist die spätere Nutzung einfacher. Dazu noch ein symbolischen Link anlegen, um ctb ohne die Endung .phar aufrufen zu können.
<source lang="bash">
ln -s ctb.phar ctb
</source>
Falls es zu einem Compiler Fehler kommt liegt es wohl an einer Einstellungen in der php.ini, dort muss definiert sein:
<source lang="ini">
[Phar]
phar.readonly = Off
</source>
Weitere Hinweise dazu: [http://php.net/phar.readonly php.net/phar.readonly]

=Konfiguration=
Um bei der Nutzung nicht immer Login und Passwort angeben zu müssen, kann man diese in seine Home-Verzeichnis in einer Konfigurationsdatei im json-Format anlegen wie folgt: <pre>`$HOME/.config/ctb/config.json`</pre>
<source lang="xml">
{
"transifex": {
"user": "john-doe",
"pass": "sUp3rPassword!"
}
}
</source>
In der composer.json der jeweiligen Erweiterung kann man ebenfalls einige Daten ablagen um die Aufrufe auf Kommandozeile zu verkürzen.
Dazu in Abschnitt extra ergänzen:
<source lang="xml">
"transifex": {
"project": "acme-core",
"prefix": "core-",
"languages_cto": "languages",
"languages_tx": ".tx"
}
</source>
Dabei bedeuten:
* "project" : der Projektname auf Transifex
* "prefix" : ein frei wählbarer Prefix, aus diesem und dem originalem Dateiname wird der Dateiname für die Ressource generiert (z.B.: core-tl_module)
* "languages_cto": Verzeichnisname in dem die Sprachunterverzeichnisse liegen (/de/..., /en/... )
* "languages_tx": Verzeichnisname in der die umgewandelten XLIFF Datein abgelegt werden sollen

Mit dem "prefix" wäre es z.B. möglich, die Sprachdateien von mehreren Teilprojekten innerhalb eines einzigen transifex Projektes zu speichern.

=Kommandozeilen Workflow=
Im Hauptverzeichnis seiner Erweiterung ruft man nun die einzelnen Jobs auf die zu erledigen sind. Dabei wird von den obigen Definitionen ausgegangen.
Das ''--verbose'' dient hier nur zu Kontrolle, was gerade durchgeführt wird. Die ''--base-language'' könnte weggelassen werden, "en" ist hier das default.

==Sprachfiles in xliff umwandeln in Verzeichnis .tx==
<source lang="bash">
ctb to-xliff --base-language="en" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb to-xliff --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --verbose
</source>

==Urpsungssprache hochladen zu Transifex==
<source lang="bash">
ctb upload-transifex --base-language="en" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb upload-transifex --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --verbose
</source>

==Übersetzen in Transifex==
Zu diesem Zeitpunkt würde nun die Online-Übersetzung auf Transifex erfolgen. Liegen bereits weitere Sprachen vor, z.B. aus ER2 Zeiten, können diese manuell hochgeladen werden, dazu später. ('''ctb''' kann dieses derzeit nicht)

==Übersetze Sprachen von Transifex laden==
<source lang="bash">
ctb download-transifex --base-language="en" --mode="translated" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb download-transifex --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --mode="translated" --verbose
</source>
Hier wurde der default Wert vom Modus "reviewed" auf "translated" geändert. Damit bekommt man alle übersetzte Sprachen, egal wieviel Prozent davon fertig sind.

==Sprachfiles in PHP umwandeln und in die Sprachverzeichnisse ablegen==
<source lang="bash">
ctb from-xliff --base-language="en" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb from-xliff --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --verbose
</source>
Dabei werden die vorhandenen nur überschrieben, wenn Änderungen vorliegen.

=Upload weiterer Sprachen=

TODO: Wird ergänzt.

<< [[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]

Transifex mit Contao Toolbox

2014-07-07T19:45:50Z

BugBuster: /* Über Git Cloning */

[[Kategorie:Transifex]]
<< [[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]
=Was ist das?=
Die Contao-Toolbox, kurz '''ctb''', gibt es auf GitHub: [https://github.com/cyberspectrum/contao-toolbox contao-toolbox] 
Das Konzept dahinter ist folgender.
* der Entwickler legt wie bisher PHP Sprachdateien an für die Ursprungsprache, z.B. "en", im Modul Unterverzeichnis language/en/
* mit ''ctb'' werden alle Sprachdateien in das XLIFF Format gewandelt
* anschließend werden die XLIFF Dateien der Ursprungsprache (default: en) mit ''ctb'' hoch geladen nach Transifex und tauchen dadurch in der Ursprungsprache als Ressourcen auf
* übersetzte Ressourcen anderer Sprachen werden mit ''ctb'' runter geladen im XLIFF Format
* anschließend werden mit ''ctb'' diese in PHP Sprachdateien umgewandelt und in das passende Verzeichnis abgelegt, z.B. language/de/

=Installation=
Die Installationanleitung entspricht der aus der Readme von ctb und kann auf zwei Arten erfolgen.
==Über composer==
Download composer wenn noch nicht vorhanden:
<source lang="bash">
curl -sS https://getcomposer.org/installer | php
</source>
Und nun die Contao Toolbox installieren:
<source lang="bash">
php composer create-project --prefer-source cyberspectrum/contao-toolbox
</source>
{{Achtung|Am Ende der Installation wird gefragt, ob die VCS History gelöscht werden kann, hier mit 'n' dieses verneinen. Sonst arbeitet der Compiler nicht richtig (folgt später)}}
<source lang="bash">
Do you want to remove the existing VCS (.git, .svn..) history? [Y,n]? n
</source>

==Über Git Cloning==
<source lang="bash">
git clone https://github.com/discordier/contao-toolbox.git
</source>
Anschließend als erstes die Abhängikeiten auflösen.
<source lang="bash">
php composer update
</source>
Um nun die ctb von überall aufrufen zu können, diese liegt ja nicht im Suchpfad, habe ich dazu noch ein Alias angelegt. Pfad in diesem Beispiel muss jeder für sich anpassen:
<source lang="bash">
alias ctb='/contao_entwicklung/contao-toolbox/bin/ctb
</source>
===Optional: eine ctb.phar kompilieren===
Zum kompilieren ruft man das mitgelieferten Compiler-Script auf.
<source lang="bash">
./bin/compile-ctb
</source>
Diese phar Datei kann man nun in ein Pfad kopieren auf dem ein Suchpfad liegt. Dadurch ist die spätere Nutzung einfacher. Dazu noch ein symbolischen Link anlegen, um ctb ohne die Endung .phar aufrufen zu können.
<source lang="bash">
ln -s ctb.phar ctb
</source>
Falls es zu einem Compiler Fehler kommt liegt es wohl an einer Einstellungen in der php.ini, dort muss definiert sein:
<source lang="ini">
[Phar]
phar.readonly = Off
</source>
Weitere Hinweise dazu: [http://php.net/phar.readonly php.net/phar.readonly]

=Konfiguration=
Um bei der Nutzung nicht immer Login und Passwort angeben zu müssen, kann man diese in seine Home-Verzeichnis in einer Konfigurationsdatei im json-Format anlegen wie folgt: <pre>`$HOME/.config/ctb/config.json`</pre>
<source lang="xml">
{
"transifex": {
"user": "john-doe",
"pass": "sUp3rPassword!"
}
}
</source>
In der composer.json der jeweiligen Erweiterung kann man ebenfalls einige Daten ablagen um die Aufrufe auf Kommandozeile zu verkürzen.
Dazu in Abschnitt extra ergänzen:
<source lang="xml">
"transifex": {
"project": "acme-core",
"prefix": "core-",
"languages_cto": "languages",
"languages_tx": ".tx"
}
</source>
Dabei bedeuten:
* "project" : der Projektname auf Transifex
* "prefix" : ein frei wählbarer Prefix, aus diesem und dem originalem Dateiname wird der Dateiname für die Ressource generiert (z.B.: core-tl_module)
* "languages_cto": Verzeichnisname in dem die Sprachunterverzeichnisse liegen (/de/..., /en/... )
* "languages_tx": Verzeichnisname in der die umgewandelten XLIFF Datein abgelegt werden sollen

Mit dem "prefix" wäre es z.B. möglich, die Sprachdateien von mehreren Teilprojekten innerhalb eines einzigen transifex Projektes zu speichern.

=Kommandozeilen Workflow=
Im Hauptverzeichnis seiner Erweiterung ruft man nun die einzelnen Jobs auf die zu erledigen sind. Dabei wird von den obigen Definitionen ausgegangen.
Das ''--verbose'' dient hier nur zu Kontrolle, was gerade durchgeführt wird. Die ''--base-language'' könnte weggelassen werden, "en" ist hier das default.

==Sprachfiles in xliff umwandeln in Verzeichnis .tx==
<source lang="bash">
ctb to-xliff --base-language="en" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb to-xliff --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --verbose
</source>

==Urpsungssprache hochladen zu Transifex==
<source lang="bash">
ctb upload-transifex --base-language="en" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb upload-transifex --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --verbose
</source>

==Übersetzen in Transifex==
Zu diesem Zeitpunkt würde nun die Online-Übersetzung auf Transifex erfolgen. Liegen bereits weitere Sprachen vor, z.B. aus ER2 Zeiten, können diese manuell hochgeladen werden, dazu später. ('''ctb''' kann dieses derzeit nicht)

==Übersetze Sprachen von Transifex laden==
<source lang="bash">
ctb download-transifex --base-language="en" --mode="translated" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb download-transifex --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --mode="translated" --verbose
</source>
Hier wurde der default Wert vom Modus "reviewed" auf "translated" geändert. Damit bekommt man alle übersetzte Sprachen, egal wieviel Prozent davon fertig sind.

==Sprachfiles in PHP umwandeln und in die Sprachverzeichnisse ablegen==
<source lang="bash">
ctb from-xliff --base-language="en" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb from-xliff --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --verbose
</source>
Dabei werden die vorhandenen nur überschrieben, wenn Änderungen vorliegen.

=Upload weiterer Sprachen=

TODO: Wird ergänzt.

<< [[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]

Transifex – Lokalisierungsplattform

2014-07-07T19:37:15Z

BugBuster: /* Nutzer Rollen */

[[Kategorie:Transifex]]
[https://www.transifex.com Transifex] ist ein Lokalisierungs-Workflow und eine Crowdsourcing-Plattform, geeignet für die Übersetzung von Software.

Contao nutzt ab Version 3.0 diese Plattform auf Basis von XLIFF Dateien, diese können ab Contao 3.1 auch direkt verarbeitet werden. 
[https://www.transifex.com/projects/p/contao/ Contao Projekt auf Transifex]

Auch für externe Erweiterungen ist dieser Service gut geeignet. Die Übersetzungen erfolgen dabei meist online, aber auch offline ist dieses möglich mit einem passenden XLIFF Editor.

Nachfolgende Seiten sollen zeigen wie Entwickler und Übersetzer damit umgehen können.

=Begriffe=
Begriffe die einem über den Weg laufen bei der Nutzung von Transifex.

==Organisation==
Eine Organisation stellt in der Regel ein Unternehmen oder ein große Lokalisierungsprojekt da, wie zum Beispiel "Contao". Ein Unternehmen hat in der Regel eine Organisation und ist verbunden mit dieser. Diese beherbergt die Übersetzungsteams und verschiedene Projekte.

==Projekt==
Ein Art Container, in dem übersetzbaren Inhalte übertragen werden. Dieser Container kann ein Computerprogramm, eine Werbekampagne, Dokumente oder ähnliches sein. Eine Organisation kann beliebige viele Projekte haben (konstenlos nur bei Open Source)

==Ressource==
Dateien, die übersetzbaren Strings enthalten. Nachdem ein Projekt erstellt wurde, kann der Nutzer seine Ressourcen uploaden, die übersetzbaren Dateien in der entsprechenden Quellsprache. Eine Ressource kann die Dokumentation eines Computerprogramms darstellen, die Worte in einem Menü, usw. Ein Projekt kann so viele Ressourcen haben, wie gebraucht werden.

==Ursprungssprache==
Beim Anlegen des Projektes in Transifex legt man die Ursprungssprache fest. Sie dient als Basissprache für alle Übersetzer in andere Sprachen. Daher bietet es sich an englisch (en) als Ursprungssprache zu definieren.
{{Achtung|Die Ursprungssprache kann später nicht mehr geändert werden. Dazu muss das ganze Projekt gelöscht und neu angelegt werden.}}

=Nutzer Rollen=
Ein Nutzer kann eine oder mehrere Rollen übernehmen innerhalb der Organisation. Hobby Entwickler mit mehreren kleinen Erweiterungen werden in der Muttersprache alle Rollen übernehmen, in anderen Sprachen nur einige davon.

==Organisations-Administrator==
Administratoren sind Benutzer, die Zugang zu bestimmten Werkzeugen auf Transifex haben somit die volle Kontrolle über eine Organisation haben.

==Projekt-Betreuer==
Diese Nutzer haben die Kontrolle über die Einstellungen eines Projekts, wie Eigentum, Löschung, maschinelle Übersetzung, TMX-Dateien, Auto-Update usw.

==Sprachteam Koordinator==
Jedes Übersetzungsteam hat mindestens einen Sprachkoordinator. Er ist für die Lokalisierung in diese spezifische Sprache verantwortlich. Er kann Übersetzer und Prüfer freigeben und auch selbst übersetzen.

==Prüfer==
Ein Benutzer, der sowohl über Übersetzungs- und Überprüfungs-Berechtigungen verfügt. Er kann entweder übersetzen, eine Übersetzung bearbeiten oder eine Übersetzung markieren als überprüft, für die Qualitätskontrolle.

==Übersetzer==
Ein Benutzer mit Berechtigungen Übersetzung, der auch in Team-Diskussionen (auf Transifex) veröffentlichen kann. Übersetzer werden auf eine bestimmte Sprache gebunden, können aber auch als Prüfer definiert werden.

=Transifex für Entwickler=
Neben den TX Client von Transifex gibt es Dank der API auch diverse externe Tools. Eines davon soll hier vorgestellt und in der Nutzunug erläutert werden.

[[Transifex_mit_TX_Client|Nutzung Transifex mit dem TX Client]]

[[Transifex_mit_Contao_Toolbox|Nutzung Transifex mit Contao-Toolbox]]

=Transifex für Übersetzer=
Transifex ist als eine Onlineplattform zum Übersetzen konzipiert. Es ist aber auch offline, also lokal möglich die Ressourcen zu übersetzen und hoch zu laden.

[[Transifex_für_Übersetzer_Online|Transifex für Übersetzer Online]]

[[Transifex_für_Übersetzer_Offline|Transifex für Übersetzer Offline]]

----
--[[Benutzer:BugBuster|BugBuster]] ([[Benutzer Diskussion:BugBuster|Diskussion]]) 15:42, 30. Jun. 2014 (CEST)

Transifex für Übersetzer Online

2014-07-07T14:50:54Z

BugBuster: /* An einem Projekt beteiligen */

[[Kategorie:Transifex]]
<< [[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]
=Registration in Transifex=
Wer nur als Übersetzer in Transifex arbeiten möchte, muss sich dort als erstes als Contributor registrieren.
* https://www.transifex.com/signup/contributor/
In der Bestätigungs-E-Mail auf den Bestätigungslink klicken.

=An einem Projekt beteiligen=
Es gibt nun zwei Wege sich an Übersetzungen zu beteiligen. 
Ein öffentliches Projekt suchen über https://www.transifex.com/connect/projects/ und dann:
* in der Sprachübersicht auf eine Sprache klicken und dort auf "Gruppe beitreten", um bei eine vorhandene Sprache mitzuwirken oder
* in der Sprachübersicht auf "Sprache anfragen", um eine neue Sprache für dieses Projekt zu öffen.

=Übersetzen einer Ressource=
Sobald man in die gewählte Sprachen wechseln kann, sieht man die Ressourcen. Diese anklicken, und dann in dem Popup auf "Jetzt übersetzen".
Nun sieht man ein Formular, links die einzelnen Wortgruppen der gewählten Ressource, in der Mitte das Original und die Übersetzung (bzw. leer), und rechts einige Statusinformation wie Vorschläge, Verlauf etc. (bei kleinerer Auflösung ist die rechte Spalte unter der mittleren)

Nun klickt man sich links die Wortgruppe raus die man übersetzen will, tut das in der Mitte und geht mit TAB zur nächsten, wobei vorher automatisch gespeichert wird, oder speichert direkt.

Ist man als Prüfer eingetragen, gibt es dort noch einen Button "Überprüfen". Damit markiert man dann, dass die Übersetzung von jemandem anderem stimmt und bestätigt wird.

Ist man mit dieser Ressource fertig, klickt man links oben auf den Ressourcen Name und bekommt eine Übersicht weiterer Ressourcen. So kann man sich durch alle Ressourcen durcharbeiten und die Wortgruppen übersetzen die man möchte. Man muss nicht alles übersetzen, ist natürlich gern gesehen, jede Kleinigkeit hilft.

<< [[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]

----
--[[Benutzer:BugBuster|BugBuster]] ([[Benutzer Diskussion:BugBuster|Diskussion]]) 16:04, 3. Jul. 2014 (CEST)

Transifex mit Contao Toolbox

2014-07-07T14:46:10Z

BugBuster: /* Kommandozeilen Workflow */

[[Kategorie:Transifex]]
<< [[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]
=Was ist das?=
Die Contao-Toolbox, kurz '''ctb''', gibt es auf GitHub: [https://github.com/cyberspectrum/contao-toolbox contao-toolbox] 
Das Konzept dahinter ist folgender.
* der Entwickler legt wie bisher PHP Sprachdateien an für die Ursprungsprache, z.B. "en", im Modul Unterverzeichnis language/en/
* mit ''ctb'' werden alle Sprachdateien in das XLIFF Format gewandelt
* anschließend werden die XLIFF Dateien der Ursprungsprache (default: en) mit ''ctb'' hoch geladen nach Transifex und tauchen dadurch in der Ursprungsprache als Ressourcen auf
* übersetzte Ressourcen anderer Sprachen werden mit ''ctb'' runter geladen im XLIFF Format
* anschließend werden mit ''ctb'' diese in PHP Sprachdateien umgewandelt und in das passende Verzeichnis abgelegt, z.B. language/de/

=Installation=
Die Installationanleitung entspricht der aus der Readme von ctb und kann auf zwei Arten erfolgen.
==Über composer==
Download composer wenn noch nicht vorhanden:
<source lang="bash">
curl -sS https://getcomposer.org/installer | php
</source>
Und nun die Contao Toolbox installieren:
<source lang="bash">
php composer create-project --prefer-source cyberspectrum/contao-toolbox
</source>
{{Achtung|Am Ende der Installation wird gefragt, ob die VCS History gelöscht werden kann, hier mit 'n' dieses verneinen. Sonst arbeitet der Compiler nicht richtig (folgt später)}}
<source lang="bash">
Do you want to remove the existing VCS (.git, .svn..) history? [Y,n]? n
</source>

==Über Git Cloning==
<source lang="bash">
git clone https://github.com/discordier/contao-toolbox.git
</source>
Anschließend als erstes die Abhängikeiten auflösen.
<source lang="bash">
php composer update
</source>

===Optional: eine ctb.phar kompilieren===
Zum kompilieren ruft man das mitgelieferten Compiler-Script auf.
<source lang="bash">
./bin/compile-ctb
</source>
Diese phar Datei kann man nun in ein Pfad kopieren auf dem ein Suchpfad liegt. Dadurch ist die spätere Nutzung einfacher. Dazu noch ein alias anlegen um ctb ohne die Endung .phar aufrufen zu können.

Falls es zu einem Compiler Fehler kommt liegt es wohl an einer Einstellunge in der php.ini, dort muss definiert sein:
<source lang="ini">
[Phar]
phar.readonly = Off
</source>
Weitere Hinweise dazu: [http://php.net/phar.readonly php.net/phar.readonly]

=Konfiguration=
Um bei der Nutzung nicht immer Login und Passwort angeben zu müssen, kann man diese in seine Home-Verzeichnis in einer Konfigurationsdatei im json-Format anlegen wie folgt: <pre>`$HOME/.config/ctb/config.json`</pre>
<source lang="xml">
{
"transifex": {
"user": "john-doe",
"pass": "sUp3rPassword!"
}
}
</source>
In der composer.json der jeweiligen Erweiterung kann man ebenfalls einige Daten ablagen um die Aufrufe auf Kommandozeile zu verkürzen.
Dazu in Abschnitt extra ergänzen:
<source lang="xml">
"transifex": {
"project": "acme-core",
"prefix": "core-",
"languages_cto": "languages",
"languages_tx": ".tx"
}
</source>
Dabei bedeuten:
* "project" : der Projektname auf Transifex
* "prefix" : ein frei wählbarer Prefix, aus diesem und dem originalem Dateiname wird der Dateiname für die Ressource generiert (z.B.: core-tl_module)
* "languages_cto": Verzeichnisname in dem die Sprachunterverzeichnisse liegen (/de/..., /en/... )
* "languages_tx": Verzeichnisname in der die umgewandelten XLIFF Datein abgelegt werden sollen

Mit dem "prefix" wäre es z.B. möglich, die Sprachdateien von mehreren Teilprojekten innerhalb eines einzigen transifex Projektes zu speichern.

=Kommandozeilen Workflow=
Im Hauptverzeichnis seiner Erweiterung ruft man nun die einzelnen Jobs auf die zu erledigen sind. Dabei wird von den obigen Definitionen ausgegangen.
Das ''--verbose'' dient hier nur zu Kontrolle, was gerade durchgeführt wird. Die ''--base-language'' könnte weggelassen werden, "en" ist hier das default.

==Sprachfiles in xliff umwandeln in Verzeichnis .tx==
<source lang="bash">
ctb to-xliff --base-language="en" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb to-xliff --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --verbose
</source>

==Urpsungssprache hochladen zu Transifex==
<source lang="bash">
ctb upload-transifex --base-language="en" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb upload-transifex --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --verbose
</source>

==Übersetzen in Transifex==
Zu diesem Zeitpunkt würde nun die Online-Übersetzung auf Transifex erfolgen. Liegen bereits weitere Sprachen vor, z.B. aus ER2 Zeiten, können diese manuell hochgeladen werden, dazu später. ('''ctb''' kann dieses derzeit nicht)

==Übersetze Sprachen von Transifex laden==
<source lang="bash">
ctb download-transifex --base-language="en" --mode="translated" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb download-transifex --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --mode="translated" --verbose
</source>
Hier wurde der default Wert vom Modus "reviewed" auf "translated" geändert. Damit bekommt man alle übersetzte Sprachen, egal wieviel Prozent davon fertig sind.

==Sprachfiles in PHP umwandeln und in die Sprachverzeichnisse ablegen==
<source lang="bash">
ctb from-xliff --base-language="en" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb from-xliff --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --verbose
</source>
Dabei werden die vorhandenen nur überschrieben, wenn Änderungen vorliegen.

=Upload weiterer Sprachen=

TODO: Wird ergänzt.

<< [[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]

Transifex mit Contao Toolbox

2014-07-07T14:44:06Z

BugBuster: /* Konfiguration */

[[Kategorie:Transifex]]
<< [[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]
=Was ist das?=
Die Contao-Toolbox, kurz '''ctb''', gibt es auf GitHub: [https://github.com/cyberspectrum/contao-toolbox contao-toolbox] 
Das Konzept dahinter ist folgender.
* der Entwickler legt wie bisher PHP Sprachdateien an für die Ursprungsprache, z.B. "en", im Modul Unterverzeichnis language/en/
* mit ''ctb'' werden alle Sprachdateien in das XLIFF Format gewandelt
* anschließend werden die XLIFF Dateien der Ursprungsprache (default: en) mit ''ctb'' hoch geladen nach Transifex und tauchen dadurch in der Ursprungsprache als Ressourcen auf
* übersetzte Ressourcen anderer Sprachen werden mit ''ctb'' runter geladen im XLIFF Format
* anschließend werden mit ''ctb'' diese in PHP Sprachdateien umgewandelt und in das passende Verzeichnis abgelegt, z.B. language/de/

=Installation=
Die Installationanleitung entspricht der aus der Readme von ctb und kann auf zwei Arten erfolgen.
==Über composer==
Download composer wenn noch nicht vorhanden:
<source lang="bash">
curl -sS https://getcomposer.org/installer | php
</source>
Und nun die Contao Toolbox installieren:
<source lang="bash">
php composer create-project --prefer-source cyberspectrum/contao-toolbox
</source>
{{Achtung|Am Ende der Installation wird gefragt, ob die VCS History gelöscht werden kann, hier mit 'n' dieses verneinen. Sonst arbeitet der Compiler nicht richtig (folgt später)}}
<source lang="bash">
Do you want to remove the existing VCS (.git, .svn..) history? [Y,n]? n
</source>

==Über Git Cloning==
<source lang="bash">
git clone https://github.com/discordier/contao-toolbox.git
</source>
Anschließend als erstes die Abhängikeiten auflösen.
<source lang="bash">
php composer update
</source>

===Optional: eine ctb.phar kompilieren===
Zum kompilieren ruft man das mitgelieferten Compiler-Script auf.
<source lang="bash">
./bin/compile-ctb
</source>
Diese phar Datei kann man nun in ein Pfad kopieren auf dem ein Suchpfad liegt. Dadurch ist die spätere Nutzung einfacher. Dazu noch ein alias anlegen um ctb ohne die Endung .phar aufrufen zu können.

Falls es zu einem Compiler Fehler kommt liegt es wohl an einer Einstellunge in der php.ini, dort muss definiert sein:
<source lang="ini">
[Phar]
phar.readonly = Off
</source>
Weitere Hinweise dazu: [http://php.net/phar.readonly php.net/phar.readonly]

=Konfiguration=
Um bei der Nutzung nicht immer Login und Passwort angeben zu müssen, kann man diese in seine Home-Verzeichnis in einer Konfigurationsdatei im json-Format anlegen wie folgt: <pre>`$HOME/.config/ctb/config.json`</pre>
<source lang="xml">
{
"transifex": {
"user": "john-doe",
"pass": "sUp3rPassword!"
}
}
</source>
In der composer.json der jeweiligen Erweiterung kann man ebenfalls einige Daten ablagen um die Aufrufe auf Kommandozeile zu verkürzen.
Dazu in Abschnitt extra ergänzen:
<source lang="xml">
"transifex": {
"project": "acme-core",
"prefix": "core-",
"languages_cto": "languages",
"languages_tx": ".tx"
}
</source>
Dabei bedeuten:
* "project" : der Projektname auf Transifex
* "prefix" : ein frei wählbarer Prefix, aus diesem und dem originalem Dateiname wird der Dateiname für die Ressource generiert (z.B.: core-tl_module)
* "languages_cto": Verzeichnisname in dem die Sprachunterverzeichnisse liegen (/de/..., /en/... )
* "languages_tx": Verzeichnisname in der die umgewandelten XLIFF Datein abgelegt werden sollen

Mit dem "prefix" wäre es z.B. möglich, die Sprachdateien von mehreren Teilprojekten innerhalb eines einzigen transifex Projektes zu speichern.

=Kommandozeilen Workflow=
Im Hauptverzeichnis seiner Erweiterung ruft man nun die einzelnen Jobs auf die zu erledigen sind. Dabei wird von den obigen Definitionen ausgegangen.
Das ''--verbose'' dient hier nur zu Kontrolle, was gerade durchgeführrt wird.

==Sprachfiles in xliff umwandeln in Verzeichnis .tx==
<source lang="bash">
ctb to-xliff --base-language="en" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb to-xliff --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --verbose
</source>

==Urpsungssprache hochladen zu Transifex==
<source lang="bash">
ctb upload-transifex --base-language="en" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb upload-transifex --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --verbose
</source>

==Übersetzen in Transifex==
Zu diesem Zeitpunkt würde nun die Online-Übersetzung auf Transifex erfolgen. Liegen bereits weitere Sprachen vor, z.B. aus ER2 Zeiten, können diese manuell hochgeladen werden, dazu später. ('''ctb''' kann dieses derzeit nicht)

==Übersetze Sprachen von Transifex laden==
<source lang="bash">
ctb download-transifex --base-language="en" --mode="translated" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb download-transifex --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --mode="translated" --verbose
</source>
Hier wurde der default Wert vom Modus "reviewed" auf "translated" geändert. Damit bekommt man alle übersetzte Sprachen, egal wieviel Prozent davon fertig sind.

==Sprachfiles in PHP umwandeln und in die Sprachverzeichnisse ablegen==
<source lang="bash">
ctb from-xliff --base-language="en" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb from-xliff --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --verbose
</source>
Dabei werden die vorhandenen nur überschrieben, wenn Änderungen vorliegen.

=Upload weiterer Sprachen=

TODO: Wird ergänzt.

<< [[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]

Transifex mit Contao Toolbox

2014-07-07T14:28:32Z

BugBuster: /* Kommandozeilen Workflow */

[[Kategorie:Transifex]]
<< [[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]
=Was ist das?=
Die Contao-Toolbox, kurz '''ctb''', gibt es auf GitHub: [https://github.com/cyberspectrum/contao-toolbox contao-toolbox] 
Das Konzept dahinter ist folgender.
* der Entwickler legt wie bisher PHP Sprachdateien an für die Ursprungsprache, z.B. "en", im Modul Unterverzeichnis language/en/
* mit ''ctb'' werden alle Sprachdateien in das XLIFF Format gewandelt
* anschließend werden die XLIFF Dateien der Ursprungsprache (default: en) mit ''ctb'' hoch geladen nach Transifex und tauchen dadurch in der Ursprungsprache als Ressourcen auf
* übersetzte Ressourcen anderer Sprachen werden mit ''ctb'' runter geladen im XLIFF Format
* anschließend werden mit ''ctb'' diese in PHP Sprachdateien umgewandelt und in das passende Verzeichnis abgelegt, z.B. language/de/

=Installation=
Die Installationanleitung entspricht der aus der Readme von ctb und kann auf zwei Arten erfolgen.
==Über composer==
Download composer wenn noch nicht vorhanden:
<source lang="bash">
curl -sS https://getcomposer.org/installer | php
</source>
Und nun die Contao Toolbox installieren:
<source lang="bash">
php composer create-project --prefer-source cyberspectrum/contao-toolbox
</source>
{{Achtung|Am Ende der Installation wird gefragt, ob die VCS History gelöscht werden kann, hier mit 'n' dieses verneinen. Sonst arbeitet der Compiler nicht richtig (folgt später)}}
<source lang="bash">
Do you want to remove the existing VCS (.git, .svn..) history? [Y,n]? n
</source>

==Über Git Cloning==
<source lang="bash">
git clone https://github.com/discordier/contao-toolbox.git
</source>
Anschließend als erstes die Abhängikeiten auflösen.
<source lang="bash">
php composer update
</source>

===Optional: eine ctb.phar kompilieren===
Zum kompilieren ruft man das mitgelieferten Compiler-Script auf.
<source lang="bash">
./bin/compile-ctb
</source>
Diese phar Datei kann man nun in ein Pfad kopieren auf dem ein Suchpfad liegt. Dadurch ist die spätere Nutzung einfacher. Dazu noch ein alias anlegen um ctb ohne die Endung .phar aufrufen zu können.

Falls es zu einem Compiler Fehler kommt liegt es wohl an einer Einstellunge in der php.ini, dort muss definiert sein:
<source lang="ini">
[Phar]
phar.readonly = Off
</source>
Weitere Hinweise dazu: [http://php.net/phar.readonly php.net/phar.readonly]

=Konfiguration=
Um bei der Nutzung nicht immer Login und Passwort angeben zu müssen, kann man diese in seine Home-Verzeichnis in einer Konfigurationsdatei im json-Format anlegen wie folgt: <pre>`$HOME/.config/ctb/config.json`</pre>
<source lang="xml">
{
"transifex": {
"user": "john-doe",
"pass": "sUp3rPassword!"
}
}
</source>
In der composer.json der jeweiligen Erweiterung kann man ebenfalls einige Daten ablagen um die Aufrufe auf Kommandozeile zu verkürzen.
Dazu in Abschnitt extra ergänzen:
<source lang="xml">
"transifex": {
"project": "acme-core",
"prefix": "core-",
"languages_cto": "languages",
"languages_tx": ".tx"
}
</source>
Dabei bedeuten:
* "project" : der Projektname auf Transifex
* "prefix" : ein frei wählbarer Prefix, aus diesem und dem originalem Dateiname wird der Dateiname für die Ressource generiert (z.B.: core-tl_module)
* "languages_cto": Verzeichnisname in dem die Sprachunterverzeichnisse liegen (/de/..., /en/... )
* "languages_tx": Verzeichnisname in der die umgewandelten XLIFF Datein abgelegt werden sollen

=Kommandozeilen Workflow=
Im Hauptverzeichnis seiner Erweiterung ruft man nun die einzelnen Jobs auf die zu erledigen sind. Dabei wird von den obigen Definitionen ausgegangen.
Das ''--verbose'' dient hier nur zu Kontrolle, was gerade durchgeführrt wird.

==Sprachfiles in xliff umwandeln in Verzeichnis .tx==
<source lang="bash">
ctb to-xliff --base-language="en" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb to-xliff --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --verbose
</source>

==Urpsungssprache hochladen zu Transifex==
<source lang="bash">
ctb upload-transifex --base-language="en" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb upload-transifex --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --verbose
</source>

==Übersetzen in Transifex==
Zu diesem Zeitpunkt würde nun die Online-Übersetzung auf Transifex erfolgen. Liegen bereits weitere Sprachen vor, z.B. aus ER2 Zeiten, können diese manuell hochgeladen werden, dazu später. ('''ctb''' kann dieses derzeit nicht)

==Übersetze Sprachen von Transifex laden==
<source lang="bash">
ctb download-transifex --base-language="en" --mode="translated" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb download-transifex --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --mode="translated" --verbose
</source>
Hier wurde der default Wert vom Modus "reviewed" auf "translated" geändert. Damit bekommt man alle übersetzte Sprachen, egal wieviel Prozent davon fertig sind.

==Sprachfiles in PHP umwandeln und in die Sprachverzeichnisse ablegen==
<source lang="bash">
ctb from-xliff --base-language="en" --verbose
</source>
In Langform wenn die composer.json und die config.json nicht definiert wären:
<source lang="bash">
ctb from-xliff --contao="languages/" --xliff=".tx/" --projectname="acme-core" --base-language="en" --prefix="core-" --user="john-doe" --pass="sUp3rPassword!" --verbose
</source>
Dabei werden die vorhandenen nur überschrieben, wenn Änderungen vorliegen.

=Upload weiterer Sprachen=

TODO: Wird ergänzt.

<< [[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]

Transifex mit Contao Toolbox

2014-07-07T14:08:07Z

BugBuster: /* Was ist das? */

Transifex mit Contao Toolbox

2014-07-07T14:05:41Z

BugBuster: /* Konfiguration */

Transifex mit Contao Toolbox

2014-07-07T13:40:51Z

BugBuster: /* Installation */

Transifex mit TX Client

2014-07-03T14:23:05Z

BugBuster:

[[Kategorie:Transifex]]
TODO: Folgt später.
{{stub}}
<< [[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]

Transifex mit Contao Toolbox

2014-07-03T14:21:36Z

BugBuster:

Transifex – Lokalisierungsplattform

2014-07-03T14:07:36Z

BugBuster: /* Transifex für Übersetzer */

[[Kategorie:Transifex]]
[https://www.transifex.com Transifex] ist ein Lokalisierungs-Workflow und eine Crowdsourcing-Plattform, geeignet für die Übersetzung von Software.

Contao nutzt ab Version 3.0 diese Plattform auf Basis von XLIFF Dateien, diese können ab Contao 3.1 auch direkt verarbeitet werden. 
[https://www.transifex.com/projects/p/contao/ Contao Projekt auf Transifex]

Auch für externe Erweiterungen ist dieser Service gut geeignet. Die Übersetzungen erfolgen dabei meist online, aber auch offline ist dieses möglich mit einem passenden XLIFF Editor.

Nachfolgende Seiten sollen zeigen wie Entwickler und Übersetzer damit umgehen können.

=Begriffe=
Begriffe die einem über den Weg laufen bei der Nutzung von Transifex.

==Organisation==
Eine Organisation stellt in der Regel ein Unternehmen oder ein große Lokalisierungsprojekt da, wie zum Beispiel "Contao". Ein Unternehmen hat in der Regel eine Organisation und ist verbunden mit dieser. Diese beherbergt die Übersetzungsteams und verschiedene Projekte.

==Projekt==
Ein Art Container, in dem übersetzbaren Inhalte übertragen werden. Dieser Container kann ein Computerprogramm, eine Werbekampagne, Dokumente oder ähnliches sein. Eine Organisation kann beliebige viele Projekte haben (konstenlos nur bei Open Source)

==Ressource==
Dateien, die übersetzbaren Strings enthalten. Nachdem ein Projekt erstellt wurde, kann der Nutzer seine Ressourcen uploaden, die übersetzbaren Dateien in der entsprechenden Quellsprache. Eine Ressource kann die Dokumentation eines Computerprogramms darstellen, die Worte in einem Menü, usw. Ein Projekt kann so viele Ressourcen haben, wie gebraucht werden.

==Ursprungssprache==
Beim Anlegen des Projektes in Transifex legt man die Ursprungssprache fest. Sie dient als Basissprache für alle Übersetzer in andere Sprachen. Daher bietet es sich an englisch (en) als Ursprungssprache zu definieren.
{{Achtung|Die Ursprungssprache kann später nicht mehr geändert werden. Dazu muss das ganze Projekt gelöscht und neu angelegt werden.}}

=Nutzer Rollen=
Ein Nutzer kann eine oder mehrere Rollen übernehmen innerhalb der Organisation. Hobby Entwickler mit mehreren kleinen Erweiterungen werden in der Muttersprache alle Rollen übernehmen, in der Ursprungssprache einige davon.

==Organisations-Administrator==
Administratoren sind Benutzer, die Zugang zu bestimmten Werkzeugen auf Transifex haben somit die volle Kontrolle über eine Organisation haben.

==Projekt-Betreuer==
Diese Nutzer haben die Kontrolle über die Einstellungen eines Projekts, wie Eigentum, Löschung, maschinelle Übersetzung, TMX-Dateien, Auto-Update usw.

==Sprachteam Koordinator==
Jedes Übersetzungsteam hat mindestens einen Sprachkoordinator. Er ist für die Lokalisierung in diese spezifische Sprache verantwortlich. Er kann Übersetzer und Prüfer freigeben und auch selbst übersetzen.

==Prüfer==
Ein Benutzer, der sowohl über Übersetzungs- und Überprüfungs-Berechtigungen verfügt. Er kann entweder übersetzen, eine Übersetzung bearbeiten oder eine Übersetzung markieren als überprüft, für die Qualitätskontrolle.

==Übersetzer==
Ein Benutzer mit Berechtigungen Übersetzung, der auch in Teamdiskussionen (auf Transifex) veröffentlichen kann. Übersetzer werden auf eine bestimmte Sprache gebunden, können aber auch als Prüfer definiert werden.

=Transifex für Entwickler=
Neben den TX Client von Transifex gibt es Dank der API auch diverse externe Tools. Eines davon soll hier vorgestellt und in der Nutzunug erläutert werden.

[[Transifex_mit_TX_Client|Nutzung Transifex mit dem TX Client]]

[[Transifex_mit_Contao_Toolbox|Nutzung Transifex mit Contao-Toolbox]]

=Transifex für Übersetzer=
Transifex ist als eine Onlineplattform zum Übersetzen konzipiert. Es ist aber auch offline, also lokal möglich die Ressourcen zu übersetzen und hoch zu laden.

[[Transifex_für_Übersetzer_Online|Transifex für Übersetzer Online]]

[[Transifex_für_Übersetzer_Offline|Transifex für Übersetzer Offline]]

----
--[[Benutzer:BugBuster|BugBuster]] ([[Benutzer Diskussion:BugBuster|Diskussion]]) 15:42, 30. Jun. 2014 (CEST)

Transifex für Übersetzer Offline

2014-07-03T14:05:39Z

BugBuster:

[[Kategorie:Transifex]]
TODO: Folgt später.

<< [[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]

Transifex für Übersetzer Online

2014-07-03T14:04:32Z

BugBuster:

[[Kategorie:Transifex]]
<< [[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]
=Registration in Transifex=
Wer nur als Übersetzer in Transifex arbeiten möchte, muss sich dort als erstes als Contributor registrieren.
* https://www.transifex.com/signup/contributor/
In der Bestätigungs-E-Mail auf den Bestätigungslink klicken.

=An einem Projekt beteiligen=
Es gibt nun zwei Wege sich an Übersetzungen zu beteiligen bzw. sich dran zu beteiligen. 
Ein öffentliches Projekt suchen über https://www.transifex.com/connect/projects/ und dann:
* in der Sprachübersicht auf eine Sprache klicken und dort auf "Gruppe beitreten", um bei eine vorhandene Sprache mitzuwirken
* in der Sprachübersicht auf "Sprache anfragen", um eine neue Sprache für dieses Projekt zu öffen.

=Übersetzen einer Ressource=
Sobald man in die gewählte Sprachen wechseln kann, sieht man die Ressourcen. Diese anklicken, und dann in dem Popup auf "Jetzt übersetzen".
Nun sieht man ein Formular, links die einzelnen Wortgruppen der gewählten Ressource, in der Mitte das Original und die Übersetzung (bzw. leer), und rechts einige Statusinformation wie Vorschläge, Verlauf etc. (bei kleinerer Auflösung ist die rechte Spalte unter der mittleren)

Nun klickt man sich links die Wortgruppe raus die man übersetzen will, tut das in der Mitte und geht mit TAB zur nächsten, wobei vorher automatisch gespeichert wird, oder speichert direkt.

Ist man als Prüfer eingetragen, gibt es dort noch einen Button "Überprüfen". Damit markiert man dann, dass die Übersetzung von jemandem anderem stimmt und bestätigt wird.

Ist man mit dieser Ressource fertig, klickt man links oben auf den Ressourcen Name und bekommt eine Übersicht weiterer Ressourcen. So kann man sich durch alle Ressourcen durcharbeiten und die Wortgruppen übersetzen die man möchte. Man muss nicht alles übersetzen, ist natürlich gern gesehen, jede Kleinigkeit hilft.

<< [[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]

----
--[[Benutzer:BugBuster|BugBuster]] ([[Benutzer Diskussion:BugBuster|Diskussion]]) 16:04, 3. Jul. 2014 (CEST)

Transifex für Übersetzer Online

2014-07-03T14:03:00Z

BugBuster: /* Übersetzen einer Ressource */

[[Kategorie:Transifex]]
=Registration in Transifex=
Wer nur als Übersetzer in Transifex arbeiten möchte, muss sich dort als erstes als Contributor registrieren.
* https://www.transifex.com/signup/contributor/
In der Bestätigungs-E-Mail auf den Bestätigungslink klicken.

=An einem Projekt beteiligen=
Es gibt nun zwei Wege sich an Übersetzungen zu beteiligen bzw. sich dran zu beteiligen. 
Ein öffentliches Projekt suchen über https://www.transifex.com/connect/projects/ und dann:
* in der Sprachübersicht auf eine Sprache klicken und dort auf "Gruppe beitreten", um bei eine vorhandene Sprache mitzuwirken
* in der Sprachübersicht auf "Sprache anfragen", um eine neue Sprache für dieses Projekt zu öffen.

=Übersetzen einer Ressource=
Sobald man in die gewählte Sprachen wechseln kann, sieht man die Ressourcen. Diese anklicken, und dann in dem Popup auf "Jetzt übersetzen".
Nun sieht man ein Formular, links die einzelnen Wortgruppen der gewählten Ressource, in der Mitte das Original und die Übersetzung (bzw. leer), und rechts einige Statusinformation wie Vorschläge, Verlauf etc. (bei kleinerer Auflösung ist die rechte Spalte unter der mittleren)

Nun klickt man sich links die Wortgruppe raus die man übersetzen will, tut das in der Mitte und geht mit TAB zur nächsten, wobei vorher automatisch gespeichert wird, oder speichert direkt.

Ist man als Prüfer eingetragen, gibt es dort noch einen Button "Überprüfen". Damit markiert man dann, dass die Übersetzung von jemandem anderem stimmt und bestätigt wird.

Ist man mit dieser Ressource fertig, klickt man links oben auf den Ressourcen Name und bekommt eine Übersicht weiterer Ressourcen. So kann man sich durch alle Ressourcen durcharbeiten und die Wortgruppen übersetzen die man möchte. Man muss nicht alles übersetzen, ist natürlich gern gesehen, jede Kleinigkeit hilft.

[[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]

Transifex für Übersetzer Online

2014-07-03T14:00:17Z

BugBuster: /* Registration in Transifex */

[[Kategorie:Transifex]]
=Registration in Transifex=
Wer nur als Übersetzer in Transifex arbeiten möchte, muss sich dort als erstes als Contributor registrieren.
* https://www.transifex.com/signup/contributor/
In der Bestätigungs-E-Mail auf den Bestätigungslink klicken.

=An einem Projekt beteiligen=
Es gibt nun zwei Wege sich an Übersetzungen zu beteiligen bzw. sich dran zu beteiligen. 
Ein öffentliches Projekt suchen über https://www.transifex.com/connect/projects/ und dann:
* in der Sprachübersicht auf eine Sprache klicken und dort auf "Gruppe beitreten", um bei eine vorhandene Sprache mitzuwirken
* in der Sprachübersicht auf "Sprache anfragen", um eine neue Sprache für dieses Projekt zu öffen.

=Übersetzen einer Ressource=
Sobald man in die gewählte Sprachen wechseln kann, sieht man die Ressourcen. Klickt man diese an, und dann in dem Popup auf "Jetzt übersetzen".
Nun sieht man ein Formular, links die einzelnen Wortgruppen der gewählten Ressource, in der Mitte Orignal und Übersetzung (bzw. leer), und rechts einige Statusinformation wie Vorschläge, Verlauf etc. (bei kleinerer Auflösung ist die rechte Spalte unter der mittleren)

Nun klickt man sich links die Wortgruppe raus die man übersetzen will, tut das in der Mitte und geht mit TAB zum nächsten, wobei vorher automatisch gespeichert wird, oder speichert direkt.

Ist man als Prüfer eingetragen, gibt es dort noch einen Button "Überprüfen". Damit markiert man dann das die Übersetzung, von jemandem anderem, stimmt und bestätigt wird.

Ist man mit dieser Ressource fertig, klickt man links oben auf den Ressourcen Name und bekommt eine Übersicht weiterer Ressourcen. So kann man sich durch alle Ressourcen durcharbeiten und die Wortgruppen übersetzen die man möchte. Man muss nicht alles übersetzen, ist natürlich gern gesehen, jede Kleinigkeit hilft.

[[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]

Transifex für Übersetzer Online

2014-07-03T13:59:19Z

BugBuster:

[[Kategorie:Transifex]]
=Registration in Transifex=
Wer nur als Übersetzer in Transifex arbeiten möchte, muss sich dort als erstes als Contributor registrieren.
* https://www.transifex.com/signup/contributor/
In der Bestätigungs-E-Mail auf den Bestätigungslink klicken.

Es gibt nun zwei Wege sich an Übersetzungen zu beteiligen bzw. sich dran zu beteiligen. 
Ein öffentliches Projekt suchen über https://www.transifex.com/connect/projects/ und dann:
* in der Sprachübersicht auf eine Sprache klicken und dort auf "Gruppe beitreten", um bei eine vorhandene Sprache mitzuwirken
* in der Sprachübersicht auf "Sprache anfragen", um eine neue Sprache für dieses Projekt zu öffen.

Sobald man in die gewählte Sprachen wechseln kann, sieht man die Ressourcen. Klickt man diese an, und dann in dem Popup auf "Jetzt übersetzen".
Nun sieht man ein Formular, links die einzelnen Wortgruppen der gewählten Ressource, in der Mitte Orignal und Übersetzung (bzw. leer), und rechts einige Statusinformation wie Vorschläge, Verlauf etc. (bei kleinerer Auflösung ist die rechte Spalte unter der mittleren)

Nun klickt man sich links die Wortgruppe raus die man übersetzen will, tut das in der Mitte und geht mit TAB zum nächsten, wobei vorher automatisch gespeichert wird, oder speichert direkt.

Ist man als Prüfer eingetragen, gibt es dort noch einen Button "Überprüfen". Damit markiert man dann das die Übersetzung, von jemandem anderem, stimmt und bestätigt wird.

Ist man mit dieser Ressource fertig, klickt man links oben auf den Ressourcen Name und bekommt eine Übersicht weiterer Ressourcen. So kann man sich durch alle Ressourcen durcharbeiten und die Wortgruppen übersetzen die man möchte. Man muss nicht alles übersetzen, ist natürlich gern gesehen, jede Kleinigkeit hilft.

[[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]

Visitors

2014-06-30T22:37:50Z

BugBuster: /* Forum */

[[File:Modul_visitors_fe_all.jpg|right|Besucher]]Ein kleines Modul welches die Zugriffe (Hits) und Besucher (Visits) zählt und zur Anzeige bringt. 
Dabei wird in der Anzeige getrennt angezeigt die Zugriffe/Besucher vom aktuellem Tag sowie die jeweilige Gesamtzahl. 
Der Zugriffszähler wird, wie der Name schon sagt, bei jedem Zugriff erhöht. Der Besucherzähler zeigt die Zahl der unterschiedlichen IP-Adressen, die innerhalb von 30 Minuten eine oder mehrere Seiten angefordert haben auf dem sich das Modul befindet. (siehe dazu auch [[Visitors#Blockzeit|Blockzeit]]) 

{{ExtInfo
| Dev=Glen Langer ([[User:BugBuster|BugBuster]])
| DevSite=http://www.contao.glen-langer.de
| ExtVersion=2.8.2 / 3.2.1
| Version=ab 2.10
| TLVersion=2.7 - 2.9 (siehe Installationshinweise)
| Depending=[[Bot Detection|Bot Detection]],[[xls_export|Excel 95 Erzeuger (xls_export)]]
| ERLink=http://www.contao.org/erweiterungsliste/view/visitors.de.html
| DonateLink=http://www.amazon.de/wishlist/26HHEJOU03G76
| TrackerLink=https://github.com/BugBuster1701/visitors/issues
| VCSLink=https://github.com/BugBuster1701/visitors
| Comment=Version für Contao 3.2 verfügbar
}}
[[en:Visitors]]
[[Kategorie:Extensions]]

=Forum=
Fragen zum Visitors-Modul werden im Forum beantwortet: [https://community.contao.org/de/forumdisplay.php?28-visitors Forum - Subforen beliebter Third-Party-Erweiterungen (Extensions) - Visitors]
 
Fehler und Wünsche können auf GitHub im [https://github.com/BugBuster1701/visitors/issues Tracking System] gemeldet werden.{{msgInfo|'''Hinweis bei gleichzeitiger Nutzung von chShop und Visitors:''' Durch einen Bug in chShop funktionierte Visitors nicht. Festgestellt bei Version 0.1.1 beta1 von chShop. Mittlerweile dort behoben (ohne jedoch die Versionsnummer anzupassen)}}
[http://www.contao-community.de/showthread.php?202-chShop-Integriertes-Bestellsystem-ohne-feste-Artikelverwaltung&p=157260&viewfull=1#post157260 Forum Beitrag zur Lösung]

=Übersetzungen=
Übersetzungen können auf [https://www.transifex.com/projects/p/contao-visitors/ Transifex] durchgeführt werden.

=Installation=
Installation erfolgt über das Extension Repository im Backend der Contao-Installation. 
Eine manuelle Installation ist möglich, dazu die ZIP-Datei [http://www.contao.org/erweiterungsliste/view/visitors.html vom Extension Repository laden], entpacken und entsprechend übertragen. 
Dadurch sollte ein Verzeichnis /system/modules/visitors angelegt worden sein. 
Danach wie dabei üblich /contao/install.php Aufrufen - Update Database durchführen. 
( /typolight/install.php bei älteren TYPOlight Installationen ) 
'''''Da das Visitors-Modul abhängig ist von den Modulen "[[Bot Detection|Bot Detection]]" und "[[xls_export|Excel 95 Erzeuger (xls_export)]]", müssen diese bei der manuellen Installation mit installiert werden.'''''

==Hinweis für ältere TYPOlight/Contao-Versionen==
===Contao 2.9===
Nutzer von Contao 2.9.x nutzen bitte Visitors-Modul-Version 2.7.1 ([http://www.contao.org/erweiterungsliste/view/visitors.20070019.de.html Direktlink])
===TYPOlight 2.8===
Nutzer von TYPOlight 2.8.x nutzen bitte Visitors-Modul-Version 1.7.2 ([http://www.contao.org/erweiterungsliste/view/visitors.10070029.de.html Direktlink])
===TYPOlight 2.7===
Nutzer von TYPOlight 2.7.x nutzen bitte Visitors-Modul-Version 1.4.1 ([http://www.contao.org/erweiterungsliste/view/visitors.10040019.de.html Direktlink])
 
==Update von Version 1.x auf Version 2.x==
{{Achtung|Die Version 2.x ist nicht vollständig kompatibel, ein Update ist aber möglich.}}
 
Was dabei zu beachten ist, kann hier nachgelesen werden.
*[[Visitors_Update_v1_auf_v2|'''Visitors-Update-Version 1 auf Version 2''']]
 

=Übersicht=
Das Visitors-Modul bringt 2 Backend- und ein Frontend-Modul mit. 
Im Backend gibt es "Besucher" und "Besucher Statistik", für das Frontend ebenfalls "Besucher".

==Backend==

===Besucher===
[[Datei:Visitors_de_backend_besucher.jpg]]

===Besucher-Statistik===
[[Datei:Visitors_de_backend_besucherstatistik.jpg]]

zeigt dann im Detail: (Klick aufs Bild für höhere Auflösung)
<gallery widths="240" heights="180" caption="Besucher Statistik">
File:Visitors_de_backend_besucherstatistikdetail.jpg|Besucher Statistik im Detail
File:Visitors_de_backend_besucherstatistikdetailBrowser.jpg|Browser Statistik
File:Visitors_de_backend_besucherstatistikdetailSearchEngine.jpg|Search Engine Referer Statistik
</gallery>

==Frontend==
Für das Frontend werden als Beispiel zwei CSS-Dateien mitgeliefert:
*mod_visitors_fe.css für die normale, zeilenweise Ausgabe
*mod_visitors_fe_horizontal.css für die horizontale Ausgabe
Ab der Version 3 liegen die css Dateien im Unterverzeichnis "css_demo". Zur Verwendung siehe [[Visitors#CSS-Datei|CSS-Datei]]

===Besucher-Statistik===
[[Datei:Modul_visitors_fe_all.jpg]]

===Besucher-Statistik horizontal===
[[Datei:Modul_visitors_fe_all_horizontal.jpg]]

=Erste Schritte=
Als erstes legt man über den Menüpunkt Besucher eine neue Besucher-Kategorie an. In dieser dann den Besucherzähler. 
Danach legt man ein Frontend-Modul an und baut es in das Layout der Seite ein. 
Hier nun die einzelnen Schritte, jeweils mit den Default-Angaben. Feinheiten werden [[Visitors#Feinheiten|später erklärt]].

==Anlegen einer Kategorie==
Um eine neue Besucher-Kategorie zu erstellen, klickt man links im Backend unter 'Inhalte' auf 'Besucher'. 
Im Hauptbereich dann auf den Button 'Neue Kategorie'.
[[Datei:Visitors_de_backend_kategorie_neu.jpg]]

Am Anfang reicht es einen Kategorie-Namen anzugeben, anschließend klickt man auf "Speichern und Schließen". 
Nun ist man in der Kategorie Übersicht. Durch Klick auf den Bleistift in der Zeile der Kategorie und nochmaligem Klick auf den Bleistift im Kopf der Kategorie gelangt man wieder zu den Einstellungen der Kategorie.

==Anlegen des Besucherzählers==
In der Kategorie Übersicht klickt man nun auf Edit (Bleistift) der Kategorie. 
Dort entweder auf 'Neuer Besucherzähler' und dann das Pfeil-Symbol oder auf das Plus im Kopf der Kategorie:
[[Datei:Visitors_de_backend_besucherzaehler_neu.jpg]]

Nun sind einige Angaben nötig:
* Namen angeben (wird über den Zahlen als Überschrift angezeigt).
* Start-Datum, ist optional, dient nur zur Anzeige im Frontend
* Optional: 'Startwerte für Zähler' eingeben
* Optional: 'Besucher pro Tag' Anzeige aktivieren
* "Veröffentlicht" aktivieren
anschließend klickt man auf "Speichern und Schließen".

==Frontend-Modul==
Ein neues Frontend-Modul wird angelegt über:
* Layout -> Themes -> Frontend Module -> Neues Modul (Contao ab 2.9)
* Layout -> Module -> Neues Modul (TYPOlight bis 2.8.x)
 
Als erstes unbedingt '''zuerst den Titel''' eingeben, erst dann bei Modultyp: 'Verschiedenes'-'Besucher' auswählen. Es ändern sich nun die Formularfelder. 
Bei 'Besucher-Kategorie' nun die vorher angelegte Kategorie auswählen, anschließend 'Speichern und Schließen'. 
 
Nun muss das angelegte Frontend-Modul noch im Layout eingebunden werden:
* Layout -> Themes -> Seitenlayout -> Edit des genutzte Layouts (Contao ab 2.9)
* Layout -> Seitenlayout -> Edit des genutzte Layouts (TYPOlight bis 2.8.x)

Bei 'Eingebundene Module' das gerade erstellte Frontend-Modul einbinden (z.b in left)

==CSS-Datei==
Wie erwähnt sind 2 CSS-Dateien mitgeliefert für die Darstellung. 
Für die ersten Tests sollte die Datei <code>mod_visitors_fe.css</code> aus dem Verzeichnis 
*Contao 2.x: <code>/system/modules/visitors</code> kopiert werden nach <code>/tl_files</code> 
*Contao 3.x: <code>/system/modules/visitors/css_demo</code> auf den lokalem PC kopiert werden 
und dann über das Backend importiert (Themes - CSS - Import) und im Layout aktiviert werden.

=Feinheiten=
Feinheiten sind einstellbar in der Kategorie, im Besucherzähler selbst sowie im selbst angelegtem Frontend-Modul.

==Feinheiten in der Kategorie Definition==
===Zählweise===
Seit Version 1.6.0 kann die Zählweise bei eingeschaltetem Seitencache gewählt werden:
* Last Zählung, serverseitig durch Contao
* Lese Zählung, clientseitig durch Browser
** (nur im Contao cacheModus: Server- und Browsercache / Nur Browsercache)

Mit dem zweiten Punkt kann damit auch gezählt werden, wenn die Seite im Browsercache liegt und daraus aufgerufen wird.
Die System-Einstellung 'Cache-Modus' wird dabei beachtet.

{{Anmerkung|Die Anzeige der aktuellen Werte erfolgt aber weiterhin nur wenn die Seite vom Server angefordert wird.}}

==Feinheiten in der Besucherzähler-Definition==
===Blockzeit===
Die Blockzeit wird in Sekunden angegeben. Nach Zugriffspause dieser Zeit wird ein Zugriff als weiterer Besucher gezählt. 
Voreingetragen sind 1800 Sekunden, d.h. 30 Minuten.

==Feinheiten in der Frontend-Modul-Definition==
===Templates===
Jedem Modul kann per Auswahl ein Template zugeordnet werden. Zur Auswahl stehen 4 Templates.
* mod_visitors_fe_all
** Liefert alle Felder die möglich sind (siehe Beispielbild oben)
* mod_visitors_fe_hits
** Hier wurden die beiden Besucherzeilen entfernt
* mod_visitors_fe_visits
** Hier wurden die beiden Zugriffszeilen entfernt
* mod_visitors_fe_invisible
** Hier wird nichts angezeigt. Dieses Template dient dadurch zur reinen Zählung.

Es können eigene Templates erstellt werden. Diese müssen als Dateiname anfangen mit 'mod_visitors_fe_' und die Endung '.tpl' (Contao <2.10) bzw. '.xhtml' oder '.html5' haben.

===Nur Gästen anzeigen===
Nach dem Aktivieren der Funktion wird das Modul versteckt, sobald ein Mitglied (Frontend-Nutzer) angemeldet ist.

===Modul schützen===
Hier kann nun definiert werden, dass die Anzeige des Moduls nur dann erfolgt, wenn Mitglieder bestimmter Gruppen online sind.

===Selbstzählung verhindern===
Es gab einige Ideen, wie man noch verhindern kann, eigene Zugriffe nicht zu zählen. Besonders, wenn man mit dynamischen IPs ankommt.
Hier ist nun eine Möglichkeit umgesetzt, dieses über einen angepassten User Agent String des Browsers zu tun.
 
Über:
* Layout -> Themes -> Frontend-Module -> Modul-Name (Contao ab 2.9)
* Layout -> Module -> Modul-Name (TYPOlight bis 2.8.x)
vom angelegtem Besucher-Modul kann im neuem Feld "Keine Zählung bei HTTP_USER_AGENT Teilkennung:" einen String eingegeben werden, dieser sollte eindeutig sein. 
Beispiel: CTISOK 
Es sind, wozu auch immer, auch mehrere Strings dort möglich, diese dann durch Komma getrennt eingeben. 
Im Firefox ergänzt man nun den Agent String wie folgt: 
# Tippe '''about:config''' in der Adresszeile ein und drücke ENTER
# Tippe '''general.useragent.extra.firefox''' in der Filter Zeile
# Doppelklick auf die gefunde Zeile
# Hier nun den Beispiel String von oben mit Leerzeichen getrennt anhängen, OK

z.B. wird so aus "Firefox/3.5.2" nun "Firefox/3.5.2 CTISOK" 
 
Die Kennung kann man sich dann durch Eingabe von '''about:''' + Enter anzeigen lassen. (letzte Zeile) 
 
Weitere Browser sind hier erläutert (eng):
[http://www.walkernews.net/2007/07/05/how-to-change-user-agent-string/ walkernews.net - how to change user agent string]
{{Hinweis|Ab Firefox 4 funktioniert das so nicht mehr. Als Alternative gibt es das Add-On [https://addons.mozilla.org/de/firefox/addon/user-agent-switcher/ User-Agent-Switcher]}}

=Insert-Tags=
Die Insert-Tags werden vom Frontend Modul selbst benutzt. Ein Nutzer benötigt diese nur, wenn das Frontend Modul nicht eingesetzt wird.
==Anzeige==
Seit der Version 1.2.0 gibt es Insert-Tags zum Anzeigen der Werte.
<source lang="text">
{{visitors::katid::name}}
{{visitors::katid::online}}
{{visitors::katid::start}}
{{visitors::katid::totalvisit}}
{{visitors::katid::totalhit}}
{{visitors::katid::todayvisit}}
{{visitors::katid::todayhit}}
{{visitors::katid::averagevisits}}
</source>
Seit der Version 1.5.0 und ab TYPOlight 2.8 können die Insert-Tags um den Präfix 'cache_' erweitert werden, damit sind diese dann auch cachesicher.
<source lang="text">
{{cache_visitors::katid::name}}
...
</source>
Das Modul zählt und zeigt normalerweise die Werte an. Wer für die Anzeige die Insert-Tags nutzen will, braucht das Modul weiterhin, aber nur zum Zählen. Mittels des Templates mod_visitors_fe_invisible kann es dazu unsichtbar geschaltet werden. 
Die "katid" ist die Kategorie-ID, in dem der Zähler angelegt wurde. Zur Ermittlung in der Kategorieübersicht des Moduls mit der Maus über das "i" gehen.

[[Datei:Visitors_de_backend_kategorie_id.jpg|Besucherzähler Kategorie-ID]]

Dabei wird als Tooltipp die ID angezeigt. 
Ab Version 2.3.1 steht die ID direkt hinter dem Kategorie-Namen. 
Bei Kategorie-ID = 1 wäre das dann also beispielsweise: 
<source lang="text">
{{visitors::1::online}}
</source>

 

==Zählung==
Eine Alternative für "nur zählen" wäre, den Insert-Tag zu nutzen, den es ab Version 1.5.0 gibt, das Modul selbst verwendet diesen ebenfalls:
<source lang="text">
{{cache_visitors::katid::count}}
</source>
Beispiel für Einbau in einen Artikel (für Kategorie-ID = 1):
<source lang="html4strict">
{{cache_visitors::1::count}}
</source>

{{Achtung|Dabei muss drauf geachtet werden, dass der Insert-Tag für die Zählung als erstes auf der Seite eingebaut wird, damit die Zählung vor der Ermittlung der Anzeigewerte erfolgt.}}

 

==Weitere Insert-Tags==
Seit der Version 2.1.0 gibt es Insert-Tags zum Anzeigen der Werte vom Tag an dem die meisten Besucher gezählt wurden.
<source lang="text">
{{visitors::katid::bestday::date}} - Tag (Datum) mit den meisten Besuchern
{{visitors::katid::bestday::visits}} - Anzahl Besucher vom Tag mit den meisten Besuchern
{{visitors::katid::bestday::hits}} - Anzahl Zugriffe vom Tag mit den meisten Besuchern
bzw.
{{cache_visitors::katid::bestday::date}}
{{cache_visitors::katid::bestday::visits}}
{{cache_visitors::katid::bestday::hits}}
</source>
Beim "date" Insert-Tag ist noch ein optionaler Parameter möglich, um die Datumsausgabe zu formatieren.(m.d.Y , Y-m-d, etc.) 
Als default wird die Systemeinstellung verwendet. Als Trennzeichen muss ein "::" verwendet werden. 
Ein komplettes Beispiel (hier mit Kategorie 1):
<source lang="text">
BestDay: {{visitors::1::bestday::date::j. F Y}} mit {{visitors::1::bestday::visits}} Besuchern (bei {{visitors::1::bestday::hits}} Hits)
</source>
ergibt:
BestDay: 31. August 2010 mit 25 Besuchern (bei 123 Hits)

 

=Besonderheiten=
==Keine Zählung==
Es wird kein Frontend-Aufruf gezählt, wenn man dabei gleichzeitig im Backend angemeldet ist. 
Es muss ein Frontend Modul angelegt und eingebunden werden, bzw. als Alternative der Insert-Tag für die Zählung (nur für Profis), sonst kann natürlich nicht gezählt werden.
 

==Besucher pro Tag: Ø = 0==
Der Durschnittswert pro Tag wird pro vollständigem Kalendertag berechnet. 
Hat man nun nur von einem Tag vorher oder gar nur vom aktuellem Tag eine Zählung, kann kein sinnvoller Wert berechnet werden. 
(Durschnitt = Anzahl Besucher) 
In diesen Fällen wird "0" angezeigt.
 

==Bot Detection abschalten==
Wer die Zugriffe von Bots und Suchmaschinen mitzählen möchte, kann die Bot Detection abschalten. Das geht allerdings nicht über das Backend, sondern muss über die localconfig.php passieren.
{{Achtung|Das gilt dann für alle Visitors-Module, falls mehrere Frontend Module angelegt wurden!}}
Folgender Eintrag ans Ende der localconfig.php (nach: ### INSTALL SCRIPT STOP ### ) bewirkt das Ausschalten: 
<source lang="php">
$GLOBALS['TL_CONFIG']['mod_visitors_bot_check'] = false;
</source>

=Datenschutz=
Einige Worte zum Thema Datenschutz. Im Gegensatz zu den meisten anderen Besucherstatistik-Tools, speichert Visitors nicht die Rohdaten und wertet diese später aus. Die notwendigen Auswertungen werden sofort ausgeführt. Gespeichert werden also die fertigen Statistik Daten, mit Außnahme der IP-Adresse, siehe dazu die Hinweise in den weiteren Kapiteln.
Somit ist das Ziel der Datenvermeidung und Datenminimierung bestmöglich erreicht.
==Datenerfassung==
===IP-Adresse===
Zur Erkennung von unterschiedlichen Besuchern wird ausschließlich die IP-Adresse genommen, kein JavaScript, keine Cookies.
===Browser-Agent und Referrer===
Für zusätzliche Statistiken wird der Browser-Agent ausgelesen und der Referrer sofern vorhanden. Beides wird unabhängig von der IP-Adresse getrennt gespeichert und kann somit auch nicht in Verbindung gebracht werden. (reine Zählung)
==Datenspeicherung==
===IP-Adresse===
Gespeichert wird nicht die IP-Adresse des Besuchers. Mit Außnahme zur Erkennung von Bots/Crawler/Spider wird die IP-Adresse auch nicht zu weiteren Analysezwecken verwendet. Aus der IP-Adresse und weiteren internen Daten wird ein Pseudonym generiert in Form eines Hashwertes. Ein Rückrechnen ist denkbar, aber nur mit erheblichem Aufwand. Der Hashwert wird mit keiner anderen statistischen Auswertung in Verbindung gebracht.
===Browser-Agent und Referrer===
Für den Browser-Agent werden die Kombinationen aus Browser,Sprache,OS mit einem Zählstand gespeichert, nicht der komplette Agent String.
Beim Referrer wird die URL gespeichert mit Zählstand und Zeitstempel des letzten Auftretens, ohne Verbindung zur IP-Adresse oder Browser-Agent.
==Datenhaltung==
Die Hashwerte zur Erkennung von unterschiedlichen Besuchern werden bei jedem Aufruf geprüft, zeitlich abgelaufende werden dabei gelöscht. Haltezeit entspricht dabei der Blockzeit, Default-Wert ist 1800 Sekunden, d.h. 30 Minuten.
Referrer Werte werden je nach Art derzeit nach 90 bzw. 120 Tagen gelöscht.

Die Anzahl der Besucher/Zugriffe je Tag wird dauerhaft gespeichert, daraus werden die weiteren Anzeigen generiert. Diese Speicherung kann über das Backend gelöscht werden, der Zähler fängt dann wieder bei 0 an.

 
----
--[[Benutzer:BugBuster|BugBuster]] 12:24, 22. Nov. 2011 (CET)

Transifex – Lokalisierungsplattform

2014-06-30T17:57:05Z

BugBuster: /* Ursprungssprache */

[[Kategorie:Transifex]]
[https://www.transifex.com Transifex] ist ein Lokalisierungs-Workflow und eine Crowdsourcing-Plattform, geeignet für die Übersetzung von Software.

Contao nutzt ab Version 3.0 diese Plattform auf Basis von XLIFF Dateien, diese können ab Contao 3.1 auch direkt verarbeitet werden. 
[https://www.transifex.com/projects/p/contao/ Contao Projekt auf Transifex]

Auch für externe Erweiterungen ist dieser Service gut geeignet. Die Übersetzungen erfolgen dabei meist online, aber auch offline ist dieses möglich mit einem passenden XLIFF Editor.

Nachfolgende Seiten sollen zeigen wie Entwickler und Übersetzer damit umgehen können.

=Begriffe=
Begriffe die einem über den Weg laufen bei der Nutzung von Transifex.

==Organisation==
Eine Organisation stellt in der Regel ein Unternehmen oder ein große Lokalisierungsprojekt da, wie zum Beispiel "Contao". Ein Unternehmen hat in der Regel eine Organisation und ist verbunden mit dieser. Diese beherbergt die Übersetzungsteams und verschiedene Projekte.

==Projekt==
Ein Art Container, in dem übersetzbaren Inhalte übertragen werden. Dieser Container kann ein Computerprogramm, eine Werbekampagne, Dokumente oder ähnliches sein. Eine Organisation kann beliebige viele Projekte haben (konstenlos nur bei Open Source)

==Ressource==
Dateien, die übersetzbaren Strings enthalten. Nachdem ein Projekt erstellt wurde, kann der Nutzer seine Ressourcen uploaden, die übersetzbaren Dateien in der entsprechenden Quellsprache. Eine Ressource kann die Dokumentation eines Computerprogramms darstellen, die Worte in einem Menü, usw. Ein Projekt kann so viele Ressourcen haben, wie gebraucht werden.

==Ursprungssprache==
Beim Anlegen des Projektes in Transifex legt man die Ursprungssprache fest. Sie dient als Basissprache für alle Übersetzer in andere Sprachen. Daher bietet es sich an englisch (en) als Ursprungssprache zu definieren.
{{Achtung|Die Ursprungssprache kann später nicht mehr geändert werden. Dazu muss das ganze Projekt gelöscht und neu angelegt werden.}}

=Nutzer Rollen=
Ein Nutzer kann eine oder mehrere Rollen übernehmen innerhalb der Organisation. Hobby Entwickler mit mehreren kleinen Erweiterungen werden in der Muttersprache alle Rollen übernehmen, in der Ursprungssprache einige davon.

==Organisations-Administrator==
Administratoren sind Benutzer, die Zugang zu bestimmten Werkzeugen auf Transifex haben somit die volle Kontrolle über eine Organisation haben.

==Projekt-Betreuer==
Diese Nutzer haben die Kontrolle über die Einstellungen eines Projekts, wie Eigentum, Löschung, maschinelle Übersetzung, TMX-Dateien, Auto-Update usw.

==Sprachteam Koordinator==
Jedes Übersetzungsteam hat mindestens einen Sprachkoordinator. Er ist für die Lokalisierung in diese spezifische Sprache verantwortlich. Er kann Übersetzer und Prüfer freigeben und auch selbst übersetzen.

==Prüfer==
Ein Benutzer, der sowohl über Übersetzungs- und Überprüfungs-Berechtigungen verfügt. Er kann entweder übersetzen, eine Übersetzung bearbeiten oder eine Übersetzung markieren als überprüft, für die Qualitätskontrolle.

==Übersetzer==
Ein Benutzer mit Berechtigungen Übersetzung, der auch in Teamdiskussionen (auf Transifex) veröffentlichen kann. Übersetzer werden auf eine bestimmte Sprache gebunden, können aber auch als Prüfer definiert werden.

=Transifex für Entwickler=
Neben den TX Client von Transifex gibt es Dank der API auch diverse externe Tools. Eines davon soll hier vorgestellt und in der Nutzunug erläutert werden.

[[Transifex_mit_TX_Client|Nutzung Transifex mit dem TX Client]]

[[Transifex_mit_Contao_Toolbox|Nutzung Transifex mit Contao-Toolbox]]

=Transifex für Übersetzer=
TODO: Registrieren, Übersetzungsanfrage, Online/Offline Übersetzung

[[Transifex_für_Übersetzer_Online|Transifex für Übersetzer Online]]

[[Transifex_für_Übersetzer_Offline|Transifex für Übersetzer Offline]]

----
--[[Benutzer:BugBuster|BugBuster]] ([[Benutzer Diskussion:BugBuster|Diskussion]]) 15:42, 30. Jun. 2014 (CEST)

Transifex – Lokalisierungsplattform

2014-06-30T13:51:16Z

BugBuster:

[[Kategorie:Transifex]]
[https://www.transifex.com Transifex] ist ein Lokalisierungs-Workflow und eine Crowdsourcing-Plattform, geeignet für die Übersetzung von Software.

Contao nutzt ab Version 3.0 diese Plattform auf Basis von XLIFF Dateien, diese können ab Contao 3.1 auch direkt verarbeitet werden. 
[https://www.transifex.com/projects/p/contao/ Contao Projekt auf Transifex]

Auch für externe Erweiterungen ist dieser Service gut geeignet. Die Übersetzungen erfolgen dabei meist online, aber auch offline ist dieses möglich mit einem passenden XLIFF Editor.

Nachfolgende Seiten sollen zeigen wie Entwickler und Übersetzer damit umgehen können.

=Begriffe=
Begriffe die einem über den Weg laufen bei der Nutzung von Transifex.

==Organisation==
Eine Organisation stellt in der Regel ein Unternehmen oder ein große Lokalisierungsprojekt da, wie zum Beispiel "Contao". Ein Unternehmen hat in der Regel eine Organisation und ist verbunden mit dieser. Diese beherbergt die Übersetzungsteams und verschiedene Projekte.

==Projekt==
Ein Art Container, in dem übersetzbaren Inhalte übertragen werden. Dieser Container kann ein Computerprogramm, eine Werbekampagne, Dokumente oder ähnliches sein. Eine Organisation kann beliebige viele Projekte haben (konstenlos nur bei Open Source)

==Ressource==
Dateien, die übersetzbaren Strings enthalten. Nachdem ein Projekt erstellt wurde, kann der Nutzer seine Ressourcen uploaden, die übersetzbaren Dateien in der entsprechenden Quellsprache. Eine Ressource kann die Dokumentation eines Computerprogramms darstellen, die Worte in einem Menü, usw. Ein Projekt kann so viele Ressourcen haben, wie gebraucht werden.

==Ursprungssprache==
Beim ersten Füllen des Projektes mit Ressourcen legt man die Ursprungssprache fest. Diese Sprache kann in Transifex selbst nicht editiert werden. Sie dient als Basissprache für alle Übersetzer in andere Sprachen. Daher bietet es sich an englisch (en) als Ursprungssprache zu definieren.
{{Achtung|Die Ursprungssprache kann später nicht mehr geändert werden. Dazu muss das ganze Projekt gelöscht und neu angelegt werden.}}

=Nutzer Rollen=
Ein Nutzer kann eine oder mehrere Rollen übernehmen innerhalb der Organisation. Hobby Entwickler mit mehreren kleinen Erweiterungen werden in der Muttersprache alle Rollen übernehmen, in der Ursprungssprache einige davon.

==Organisations-Administrator==
Administratoren sind Benutzer, die Zugang zu bestimmten Werkzeugen auf Transifex haben somit die volle Kontrolle über eine Organisation haben.

==Projekt-Betreuer==
Diese Nutzer haben die Kontrolle über die Einstellungen eines Projekts, wie Eigentum, Löschung, maschinelle Übersetzung, TMX-Dateien, Auto-Update usw.

==Sprachteam Koordinator==
Jedes Übersetzungsteam hat mindestens einen Sprachkoordinator. Er ist für die Lokalisierung in diese spezifische Sprache verantwortlich. Er kann Übersetzer und Prüfer freigeben und auch selbst übersetzen.

==Prüfer==
Ein Benutzer, der sowohl über Übersetzungs- und Überprüfungs-Berechtigungen verfügt. Er kann entweder übersetzen, eine Übersetzung bearbeiten oder eine Übersetzung markieren als überprüft, für die Qualitätskontrolle.

==Übersetzer==
Ein Benutzer mit Berechtigungen Übersetzung, der auch in Teamdiskussionen (auf Transifex) veröffentlichen kann. Übersetzer werden auf eine bestimmte Sprache gebunden, können aber auch als Prüfer definiert werden.

=Transifex für Entwickler=
Neben den TX Client von Transifex gibt es Dank der API auch diverse externe Tools. Eines davon soll hier vorgestellt und in der Nutzunug erläutert werden.

[[Transifex_mit_TX_Client|Nutzung Transifex mit dem TX Client]]

[[Transifex_mit_Contao_Toolbox|Nutzung Transifex mit Contao-Toolbox]]

=Transifex für Übersetzer=
TODO: Registrieren, Übersetzungsanfrage, Online/Offline Übersetzung

[[Transifex_für_Übersetzer_Online|Transifex für Übersetzer Online]]

[[Transifex_für_Übersetzer_Offline|Transifex für Übersetzer Offline]]

----
--[[Benutzer:BugBuster|BugBuster]] ([[Benutzer Diskussion:BugBuster|Diskussion]]) 15:42, 30. Jun. 2014 (CEST)

Transifex – Lokalisierungsplattform

2014-06-30T13:48:04Z

BugBuster: /* Nutzer Rollen */

[[Kategorie:Transifex]]
[https://www.transifex.com Transifex] ist ein Lokalisierungs-Workflow und eine Crowdsourcing-Plattform, geeignet für die Übersetzung von Software.

Contao nutzt ab Version 3.0 diese Plattform auf Basis von XLIFF Dateien, diese können ab Contao 3.1 auch direkt verarbeitet werden. 
[https://www.transifex.com/projects/p/contao/ Contao Projekt auf Transifex]

Auch für externe Erweiterungen ist dieser Service gut geeignet. Die Übersetzungen erfolgen dabei meist online, aber auch offline ist dieses möglich mit einen passenden XLIFF Editor.

Nachfolgende Seiten sollen zeigen wie Entwickler und Übersetzer damit umgehen können.

=Begriffe=
Begriffe die einem über den Weg laufen bei der Nutzung von Transifex.

==Organisation==
Eine Organisation stellt in der Regel ein Unternehmen oder ein große Lokalisierungsprojekt da, wie zum Beispiel "Contao". Ein Unternehmen hat in der Regel eine Organisation und ist verbunden mit dieser. Diese beherbergt die Übersetzungsteams und verschiedene Projekte.

==Projekt==
Ein Art Container, in dem übersetzbaren Inhalte übertragen werden. Dieser Container kann ein Computerprogramm, eine Werbekampagne, Dokumente oder ähnliches sein. Eine Organisation kann beliebige viele Projekte haben (konstenlos nur bei Open Source)

==Ressource==
Dateien, die übersetzbaren Strings enthalten. Nachdem ein Projekt erstellt wurde, kann der Nutzer seine Ressourcen uploaden, die übersetzbaren Dateien in der entsprechenden Quellsprache. Eine Ressource kann die Dokumentation eines Computerprogramms darstellen, die Worte in einem Menü, usw. Ein Projekt kann so viele Ressourcen haben, wie gebraucht werden.

==Ursprungssprache==
Beim ersten Füllen des Projektes mit Ressourcen legt man die Ursprungssprache fest. Diese Sprache kann in Transifex selbst nicht editiert werden. Sie dient als Basissprache für alle Übersetzer in andere Sprachen. Daher bietet es sich an englisch (en) als Ursprungssprache zu definieren.
{{Achtung|Die Ursprungssprache kann später nicht mehr geändert werden. Dazu muss das ganze Projekt gelöscht und neu angelegt werden.}}

=Nutzer Rollen=
Ein Nutzer kann eine oder mehrere Rollen übernehmen innerhalb der Organisation. Hobby Entwickler mit mehreren kleinen Erweiterungen werden in der Muttersprache alle Rollen übernehmen, in der Ursprungssprache einige davon.

==Organisations-Administrator==
Administratoren sind Benutzer, die Zugang zu bestimmten Werkzeugen auf Transifex haben somit die volle Kontrolle über eine Organisation haben.

==Projekt-Betreuer==
Diese Nutzer haben die Kontrolle über die Einstellungen eines Projekts, wie Eigentum, Löschung, maschinelle Übersetzung, TMX-Dateien, Auto-Update usw.

==Sprachteam Koordinator==
Jedes Übersetzungsteam hat mindestens einen Sprachkoordinator. Er ist für die Lokalisierung in diese spezifische Sprache verantwortlich. Er kann Übersetzer und Prüfer freigeben und auch selbst übersetzen.

==Prüfer==
Ein Benutzer, der sowohl über Übersetzungs- und Überprüfungs-Berechtigungen verfügt. Er kann entweder übersetzen, eine Übersetzung bearbeiten oder eine Übersetzung markieren als überprüft, für die Qualitätskontrolle.

==Übersetzer==
Ein Benutzer mit Berechtigungen Übersetzung, der auch in Teamdiskussionen (auf Transifex) veröffentlichen kann. Übersetzer werden auf eine bestimmte Sprache gebunden, können aber auch als Prüfer definiert werden.

=Transifex für Entwickler=
Neben den TX Client von Transifex gibt es Dank der API auch diverse externe Tools. Eines davon soll hier vorgestellt und in der Nutzunug erläutert werden.

[[Transifex_mit_TX_Client|Nutzung Transifex mit dem TX Client]]

[[Transifex_mit_Contao_Toolbox|Nutzung Transifex mit Contao-Toolbox]]

=Transifex für Übersetzer=
TODO: Registrieren, Übersetzungsanfrage, Online/Offline Übersetzung

[[Transifex_für_Übersetzer_Online|Transifex für Übersetzer Online]]

[[Transifex_für_Übersetzer_Offline|Transifex für Übersetzer Offline]]

----
--[[Benutzer:BugBuster|BugBuster]] ([[Benutzer Diskussion:BugBuster|Diskussion]]) 15:42, 30. Jun. 2014 (CEST)

Transifex – Lokalisierungsplattform

2014-06-30T13:44:35Z

BugBuster: /* Transifex für Entwickler */

[[Kategorie:Transifex]]
[https://www.transifex.com Transifex] ist ein Lokalisierungs-Workflow und eine Crowdsourcing-Plattform, geeignet für die Übersetzung von Software.

Contao nutzt ab Version 3.0 diese Plattform auf Basis von XLIFF Dateien, diese können ab Contao 3.1 auch direkt verarbeitet werden. 
[https://www.transifex.com/projects/p/contao/ Contao Projekt auf Transifex]

Auch für externe Erweiterungen ist dieser Service gut geeignet. Die Übersetzungen erfolgen dabei meist online, aber auch offline ist dieses möglich mit einen passenden XLIFF Editor.

Nachfolgende Seiten sollen zeigen wie Entwickler und Übersetzer damit umgehen können.

=Begriffe=
Begriffe die einem über den Weg laufen bei der Nutzung von Transifex.

==Organisation==
Eine Organisation stellt in der Regel ein Unternehmen oder ein große Lokalisierungsprojekt da, wie zum Beispiel "Contao". Ein Unternehmen hat in der Regel eine Organisation und ist verbunden mit dieser. Diese beherbergt die Übersetzungsteams und verschiedene Projekte.

==Projekt==
Ein Art Container, in dem übersetzbaren Inhalte übertragen werden. Dieser Container kann ein Computerprogramm, eine Werbekampagne, Dokumente oder ähnliches sein. Eine Organisation kann beliebige viele Projekte haben (konstenlos nur bei Open Source)

==Ressource==
Dateien, die übersetzbaren Strings enthalten. Nachdem ein Projekt erstellt wurde, kann der Nutzer seine Ressourcen uploaden, die übersetzbaren Dateien in der entsprechenden Quellsprache. Eine Ressource kann die Dokumentation eines Computerprogramms darstellen, die Worte in einem Menü, usw. Ein Projekt kann so viele Ressourcen haben, wie gebraucht werden.

==Ursprungssprache==
Beim ersten Füllen des Projektes mit Ressourcen legt man die Ursprungssprache fest. Diese Sprache kann in Transifex selbst nicht editiert werden. Sie dient als Basissprache für alle Übersetzer in andere Sprachen. Daher bietet es sich an englisch (en) als Ursprungssprache zu definieren.
{{Achtung|Die Ursprungssprache kann später nicht mehr geändert werden. Dazu muss das ganze Projekt gelöscht und neu angelegt werden.}}

=Nutzer Rollen=
==Organisations-Administrator==
Administratoren sind Benutzer, die Zugang zu bestimmten Werkzeugen auf Transifex haben somit die volle Kontrolle über eine Organisation haben.

==Projekt-Betreuer==
Diese Nutzer haben die Kontrolle über die Einstellungen eines Projekts, wie Eigentum, Löschung, maschinelle Übersetzung, TMX-Dateien, Auto-Update usw.

==Sprachteam Koordinator==
Jedes Übersetzungsteam hat mindestens einen Sprachkoordinator. Er ist für die Lokalisierung in diese spezifische Sprache verantwortlich. Er kann Übersetzer und Prüfer freigeben und auch selbst übersetzen.

==Prüfer==
Ein Benutzer, der sowohl über Übersetzungs- und Überprüfungs-Berechtigungen verfügt. Er kann entweder übersetzen, eine Übersetzung bearbeiten oder eine Übersetzung markieren als überprüft, für die Qualitätskontrolle.

==Übersetzer==
Ein Benutzer mit Berechtigungen Übersetzung, der auch in Teamdiskussionen (auf Transifex) veröffentlichen kann. Übersetzer werden auf eine bestimmte Sprache gebunden, können aber auch als Prüfer definiert werden.

=Transifex für Entwickler=
Neben den TX Client von Transifex gibt es Dank der API auch diverse externe Tools. Eines davon soll hier vorgestellt und in der Nutzunug erläutert werden.

[[Transifex_mit_TX_Client|Nutzung Transifex mit dem TX Client]]

[[Transifex_mit_Contao_Toolbox|Nutzung Transifex mit Contao-Toolbox]]

=Transifex für Übersetzer=
TODO: Registrieren, Übersetzungsanfrage, Online/Offline Übersetzung

[[Transifex_für_Übersetzer_Online|Transifex für Übersetzer Online]]

[[Transifex_für_Übersetzer_Offline|Transifex für Übersetzer Offline]]

----
--[[Benutzer:BugBuster|BugBuster]] ([[Benutzer Diskussion:BugBuster|Diskussion]]) 15:42, 30. Jun. 2014 (CEST)

Transifex – Lokalisierungsplattform

2014-06-30T13:42:23Z

BugBuster: /* Transifex für Übersetzer */

[[Kategorie:Transifex]]
[https://www.transifex.com Transifex] ist ein Lokalisierungs-Workflow und eine Crowdsourcing-Plattform, geeignet für die Übersetzung von Software.

Contao nutzt ab Version 3.0 diese Plattform auf Basis von XLIFF Dateien, diese können ab Contao 3.1 auch direkt verarbeitet werden. 
[https://www.transifex.com/projects/p/contao/ Contao Projekt auf Transifex]

Auch für externe Erweiterungen ist dieser Service gut geeignet. Die Übersetzungen erfolgen dabei meist online, aber auch offline ist dieses möglich mit einen passenden XLIFF Editor.

Nachfolgende Seiten sollen zeigen wie Entwickler und Übersetzer damit umgehen können.

=Begriffe=
Begriffe die einem über den Weg laufen bei der Nutzung von Transifex.

==Organisation==
Eine Organisation stellt in der Regel ein Unternehmen oder ein große Lokalisierungsprojekt da, wie zum Beispiel "Contao". Ein Unternehmen hat in der Regel eine Organisation und ist verbunden mit dieser. Diese beherbergt die Übersetzungsteams und verschiedene Projekte.

==Projekt==
Ein Art Container, in dem übersetzbaren Inhalte übertragen werden. Dieser Container kann ein Computerprogramm, eine Werbekampagne, Dokumente oder ähnliches sein. Eine Organisation kann beliebige viele Projekte haben (konstenlos nur bei Open Source)

==Ressource==
Dateien, die übersetzbaren Strings enthalten. Nachdem ein Projekt erstellt wurde, kann der Nutzer seine Ressourcen uploaden, die übersetzbaren Dateien in der entsprechenden Quellsprache. Eine Ressource kann die Dokumentation eines Computerprogramms darstellen, die Worte in einem Menü, usw. Ein Projekt kann so viele Ressourcen haben, wie gebraucht werden.

==Ursprungssprache==
Beim ersten Füllen des Projektes mit Ressourcen legt man die Ursprungssprache fest. Diese Sprache kann in Transifex selbst nicht editiert werden. Sie dient als Basissprache für alle Übersetzer in andere Sprachen. Daher bietet es sich an englisch (en) als Ursprungssprache zu definieren.
{{Achtung|Die Ursprungssprache kann später nicht mehr geändert werden. Dazu muss das ganze Projekt gelöscht und neu angelegt werden.}}

=Nutzer Rollen=
==Organisations-Administrator==
Administratoren sind Benutzer, die Zugang zu bestimmten Werkzeugen auf Transifex haben somit die volle Kontrolle über eine Organisation haben.

==Projekt-Betreuer==
Diese Nutzer haben die Kontrolle über die Einstellungen eines Projekts, wie Eigentum, Löschung, maschinelle Übersetzung, TMX-Dateien, Auto-Update usw.

==Sprachteam Koordinator==
Jedes Übersetzungsteam hat mindestens einen Sprachkoordinator. Er ist für die Lokalisierung in diese spezifische Sprache verantwortlich. Er kann Übersetzer und Prüfer freigeben und auch selbst übersetzen.

==Prüfer==
Ein Benutzer, der sowohl über Übersetzungs- und Überprüfungs-Berechtigungen verfügt. Er kann entweder übersetzen, eine Übersetzung bearbeiten oder eine Übersetzung markieren als überprüft, für die Qualitätskontrolle.

==Übersetzer==
Ein Benutzer mit Berechtigungen Übersetzung, der auch in Teamdiskussionen (auf Transifex) veröffentlichen kann. Übersetzer werden auf eine bestimmte Sprache gebunden, können aber auch als Prüfer definiert werden.

=Transifex für Entwickler=
Neben den TX Client von Transifex gibt es Dank der API auch diverse externe Tool. Eines davon soll hier vorgestellt und in der Nutzunug erläutert werden.

[[Transifex_mit_TX_Client|Nutzung Transifex mit dem TX Client]]

[[Transifex_mit_Contao_Toolbox|Nutzung Transifex mit Contao-Toolbox]]

=Transifex für Übersetzer=
TODO: Registrieren, Übersetzungsanfrage, Online/Offline Übersetzung

[[Transifex_für_Übersetzer_Online|Transifex für Übersetzer Online]]

[[Transifex_für_Übersetzer_Offline|Transifex für Übersetzer Offline]]

----
--[[Benutzer:BugBuster|BugBuster]] ([[Benutzer Diskussion:BugBuster|Diskussion]]) 15:42, 30. Jun. 2014 (CEST)

Transifex – Lokalisierungsplattform

2014-06-30T13:42:10Z

BugBuster: /* Übersetzer */

[[Kategorie:Transifex]]
[https://www.transifex.com Transifex] ist ein Lokalisierungs-Workflow und eine Crowdsourcing-Plattform, geeignet für die Übersetzung von Software.

Contao nutzt ab Version 3.0 diese Plattform auf Basis von XLIFF Dateien, diese können ab Contao 3.1 auch direkt verarbeitet werden. 
[https://www.transifex.com/projects/p/contao/ Contao Projekt auf Transifex]

Auch für externe Erweiterungen ist dieser Service gut geeignet. Die Übersetzungen erfolgen dabei meist online, aber auch offline ist dieses möglich mit einen passenden XLIFF Editor.

Nachfolgende Seiten sollen zeigen wie Entwickler und Übersetzer damit umgehen können.

=Begriffe=
Begriffe die einem über den Weg laufen bei der Nutzung von Transifex.

==Organisation==
Eine Organisation stellt in der Regel ein Unternehmen oder ein große Lokalisierungsprojekt da, wie zum Beispiel "Contao". Ein Unternehmen hat in der Regel eine Organisation und ist verbunden mit dieser. Diese beherbergt die Übersetzungsteams und verschiedene Projekte.

==Projekt==
Ein Art Container, in dem übersetzbaren Inhalte übertragen werden. Dieser Container kann ein Computerprogramm, eine Werbekampagne, Dokumente oder ähnliches sein. Eine Organisation kann beliebige viele Projekte haben (konstenlos nur bei Open Source)

==Ressource==
Dateien, die übersetzbaren Strings enthalten. Nachdem ein Projekt erstellt wurde, kann der Nutzer seine Ressourcen uploaden, die übersetzbaren Dateien in der entsprechenden Quellsprache. Eine Ressource kann die Dokumentation eines Computerprogramms darstellen, die Worte in einem Menü, usw. Ein Projekt kann so viele Ressourcen haben, wie gebraucht werden.

==Ursprungssprache==
Beim ersten Füllen des Projektes mit Ressourcen legt man die Ursprungssprache fest. Diese Sprache kann in Transifex selbst nicht editiert werden. Sie dient als Basissprache für alle Übersetzer in andere Sprachen. Daher bietet es sich an englisch (en) als Ursprungssprache zu definieren.
{{Achtung|Die Ursprungssprache kann später nicht mehr geändert werden. Dazu muss das ganze Projekt gelöscht und neu angelegt werden.}}

=Nutzer Rollen=
==Organisations-Administrator==
Administratoren sind Benutzer, die Zugang zu bestimmten Werkzeugen auf Transifex haben somit die volle Kontrolle über eine Organisation haben.

==Projekt-Betreuer==
Diese Nutzer haben die Kontrolle über die Einstellungen eines Projekts, wie Eigentum, Löschung, maschinelle Übersetzung, TMX-Dateien, Auto-Update usw.

==Sprachteam Koordinator==
Jedes Übersetzungsteam hat mindestens einen Sprachkoordinator. Er ist für die Lokalisierung in diese spezifische Sprache verantwortlich. Er kann Übersetzer und Prüfer freigeben und auch selbst übersetzen.

==Prüfer==
Ein Benutzer, der sowohl über Übersetzungs- und Überprüfungs-Berechtigungen verfügt. Er kann entweder übersetzen, eine Übersetzung bearbeiten oder eine Übersetzung markieren als überprüft, für die Qualitätskontrolle.

==Übersetzer==
Ein Benutzer mit Berechtigungen Übersetzung, der auch in Teamdiskussionen (auf Transifex) veröffentlichen kann. Übersetzer werden auf eine bestimmte Sprache gebunden, können aber auch als Prüfer definiert werden.

=Transifex für Entwickler=
Neben den TX Client von Transifex gibt es Dank der API auch diverse externe Tool. Eines davon soll hier vorgestellt und in der Nutzunug erläutert werden.

[[Transifex_mit_TX_Client|Nutzung Transifex mit dem TX Client]]

[[Transifex_mit_Contao_Toolbox|Nutzung Transifex mit Contao-Toolbox]]

=Transifex für Übersetzer=
TODO: Registrieren, Übersetzungsanfrage, Online/Offline Übersetzung

[[Transifex_für_Übersetzer_Online|Transifex für Übersetzer Online]]

[[Transifex_für_Übersetzer_Offline|Transifex für Übersetzer Offline]]

Transifex – Lokalisierungsplattform

2014-06-30T13:41:07Z

BugBuster: /* Begriffe */

[[Kategorie:Transifex]]
[https://www.transifex.com Transifex] ist ein Lokalisierungs-Workflow und eine Crowdsourcing-Plattform, geeignet für die Übersetzung von Software.

Contao nutzt ab Version 3.0 diese Plattform auf Basis von XLIFF Dateien, diese können ab Contao 3.1 auch direkt verarbeitet werden. 
[https://www.transifex.com/projects/p/contao/ Contao Projekt auf Transifex]

Auch für externe Erweiterungen ist dieser Service gut geeignet. Die Übersetzungen erfolgen dabei meist online, aber auch offline ist dieses möglich mit einen passenden XLIFF Editor.

Nachfolgende Seiten sollen zeigen wie Entwickler und Übersetzer damit umgehen können.

=Begriffe=
Begriffe die einem über den Weg laufen bei der Nutzung von Transifex.

==Organisation==
Eine Organisation stellt in der Regel ein Unternehmen oder ein große Lokalisierungsprojekt da, wie zum Beispiel "Contao". Ein Unternehmen hat in der Regel eine Organisation und ist verbunden mit dieser. Diese beherbergt die Übersetzungsteams und verschiedene Projekte.

==Projekt==
Ein Art Container, in dem übersetzbaren Inhalte übertragen werden. Dieser Container kann ein Computerprogramm, eine Werbekampagne, Dokumente oder ähnliches sein. Eine Organisation kann beliebige viele Projekte haben (konstenlos nur bei Open Source)

==Ressource==
Dateien, die übersetzbaren Strings enthalten. Nachdem ein Projekt erstellt wurde, kann der Nutzer seine Ressourcen uploaden, die übersetzbaren Dateien in der entsprechenden Quellsprache. Eine Ressource kann die Dokumentation eines Computerprogramms darstellen, die Worte in einem Menü, usw. Ein Projekt kann so viele Ressourcen haben, wie gebraucht werden.

==Ursprungssprache==
Beim ersten Füllen des Projektes mit Ressourcen legt man die Ursprungssprache fest. Diese Sprache kann in Transifex selbst nicht editiert werden. Sie dient als Basissprache für alle Übersetzer in andere Sprachen. Daher bietet es sich an englisch (en) als Ursprungssprache zu definieren.
{{Achtung|Die Ursprungssprache kann später nicht mehr geändert werden. Dazu muss das ganze Projekt gelöscht und neu angelegt werden.}}

=Nutzer Rollen=
==Organisations-Administrator==
Administratoren sind Benutzer, die Zugang zu bestimmten Werkzeugen auf Transifex haben somit die volle Kontrolle über eine Organisation haben.

==Projekt-Betreuer==
Diese Nutzer haben die Kontrolle über die Einstellungen eines Projekts, wie Eigentum, Löschung, maschinelle Übersetzung, TMX-Dateien, Auto-Update usw.

==Sprachteam Koordinator==
Jedes Übersetzungsteam hat mindestens einen Sprachkoordinator. Er ist für die Lokalisierung in diese spezifische Sprache verantwortlich. Er kann Übersetzer und Prüfer freigeben und auch selbst übersetzen.

==Prüfer==
Ein Benutzer, der sowohl über Übersetzungs- und Überprüfungs-Berechtigungen verfügt. Er kann entweder übersetzen, eine Übersetzung bearbeiten oder eine Übersetzung markieren als überprüft, für die Qualitätskontrolle.

==Übersetzer==
Ein Benutzer mit Berechtigungen Übersetzung, der auch in Teamdiskussionen (auf Transifex) veröffentlichen kann. Übersetzer werden auf eine bestimmte Sprache gebunden, können auch als Prüfer definiert werden.

=Transifex für Entwickler=
Neben den TX Client von Transifex gibt es Dank der API auch diverse externe Tool. Eines davon soll hier vorgestellt und in der Nutzunug erläutert werden.

[[Transifex_mit_TX_Client|Nutzung Transifex mit dem TX Client]]

[[Transifex_mit_Contao_Toolbox|Nutzung Transifex mit Contao-Toolbox]]

=Transifex für Übersetzer=
TODO: Registrieren, Übersetzungsanfrage, Online/Offline Übersetzung

[[Transifex_für_Übersetzer_Online|Transifex für Übersetzer Online]]

[[Transifex_für_Übersetzer_Offline|Transifex für Übersetzer Offline]]

Transifex mit Contao Toolbox

2014-06-30T13:38:15Z

BugBuster:

[[Kategorie:Transifex]]
Die Contao-Toolbox gibt es auf GitHub: [https://github.com/cyberspectrum/contao-toolbox contao-toolbox]

TODO: Folgt noch.

[[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]

Transifex für Übersetzer Offline

2014-06-30T13:36:03Z

BugBuster: Die Seite wurde neu angelegt: „Kategorie:Transifex TODO: Folgt später. Zum Hauptartikel“

[[Kategorie:Transifex]]
TODO: Folgt später.

[[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]

Transifex – Lokalisierungsplattform

2014-06-30T13:35:48Z

BugBuster: /* Transifex für Übersetzer */

[[Kategorie:Transifex]]
[https://www.transifex.com Transifex] ist ein Lokalisierungs-Workflow und eine Crowdsourcing-Plattform, geeignet für die Übersetzung von Software.

Contao nutzt ab Version 3.0 diese Plattform auf Basis von XLIFF Dateien, diese können ab Contao 3.1 auch direkt verarbeitet werden. 
[https://www.transifex.com/projects/p/contao/ Contao Projekt auf Transifex]

Auch für externe Erweiterungen ist dieser Service gut geeignet. Die Übersetzungen erfolgen dabei meist online, aber auch offline ist dieses möglich mit einen passenden XLIFF Editor.

Nachfolgende Seiten sollen zeigen wie Entwickler und Übersetzer damit umgehen können.

=Begriffe=
==Organisation==
Eine Organisation stellt in der Regel ein Unternehmen oder ein große Lokalisierungsprojekt da, wie zum Beispiel "Contao". Ein Unternehmen hat in der Regel eine Organisation und ist verbunden mit dieser. Diese beherbergt die Übersetzungsteams und verschiedene Projekte.

==Projekt==
Ein Art Container, in dem übersetzbaren Inhalte übertragen werden. Dieser Container kann ein Computerprogramm, eine Werbekampagne, Dokumente oder ähnliches sein. Eine Organisation kann beliebige viele Projekte haben (konstenlos nur bei Open Source)

==Ressource==
Dateien, die übersetzbaren Strings enthalten. Nachdem ein Projekt erstellt wurde, kann der Nutzer seine Ressourcen uploaden, die übersetzbaren Dateien in der entsprechenden Quellsprache. Eine Ressource kann die Dokumentation eines Computerprogramms darstellen, die Worte in einem Menü, usw. Ein Projekt kann so viele Ressourcen haben, wie gebraucht werden.

==Ursprungssprache==
Beim ersten Füllen des Projektes mit Ressourcen legt man die Ursprungssprache fest. Diese Sprache kann in Transifex selbst nicht editiert werden. Sie dient als Basissprache für alle Übersetzer in andere Sprachen. Daher bietet es sich an englisch (en) als Ursprungssprache zu definieren.
{{Achtung|Die Ursprungssprache kann später nicht mehr geändert werden. Dazu muss das ganze Projekt gelöscht und neu angelegt werden.}}

=Nutzer Rollen=
==Organisations-Administrator==
Administratoren sind Benutzer, die Zugang zu bestimmten Werkzeugen auf Transifex haben somit die volle Kontrolle über eine Organisation haben.

==Projekt-Betreuer==
Diese Nutzer haben die Kontrolle über die Einstellungen eines Projekts, wie Eigentum, Löschung, maschinelle Übersetzung, TMX-Dateien, Auto-Update usw.

==Sprachteam Koordinator==
Jedes Übersetzungsteam hat mindestens einen Sprachkoordinator. Er ist für die Lokalisierung in diese spezifische Sprache verantwortlich. Er kann Übersetzer und Prüfer freigeben und auch selbst übersetzen.

==Prüfer==
Ein Benutzer, der sowohl über Übersetzungs- und Überprüfungs-Berechtigungen verfügt. Er kann entweder übersetzen, eine Übersetzung bearbeiten oder eine Übersetzung markieren als überprüft, für die Qualitätskontrolle.

==Übersetzer==
Ein Benutzer mit Berechtigungen Übersetzung, der auch in Teamdiskussionen (auf Transifex) veröffentlichen kann. Übersetzer werden auf eine bestimmte Sprache gebunden, können auch als Prüfer definiert werden.

=Transifex für Entwickler=
Neben den TX Client von Transifex gibt es Dank der API auch diverse externe Tool. Eines davon soll hier vorgestellt und in der Nutzunug erläutert werden.

[[Transifex_mit_TX_Client|Nutzung Transifex mit dem TX Client]]

[[Transifex_mit_Contao_Toolbox|Nutzung Transifex mit Contao-Toolbox]]

=Transifex für Übersetzer=
TODO: Registrieren, Übersetzungsanfrage, Online/Offline Übersetzung

[[Transifex_für_Übersetzer_Online|Transifex für Übersetzer Online]]

[[Transifex_für_Übersetzer_Offline|Transifex für Übersetzer Offline]]

Transifex für Übersetzer Online

2014-06-30T13:35:14Z

BugBuster:

[[Kategorie:Transifex]]
TODO: Folgt später.

[[Transifex_–_Lokalisierungsplattform|Zum Hauptartikel]]