# Das Onlinebeteiligungstool der grünen Bundestagsfraktion #

## Installation (Github + typo3 Introduction Package) ##
The english manual with a tutorial can be found in doc/

- Lade das [Introduction Package](http://typo3.org/download/) in der Version 4.5 herunter und bringe es zum laufen.
- Erstelle einen neuen Ordner in `htdocs\typo3conf\ext\` und nenne ihn `we_betatext`, kopiere die Dateien der Extension dort hinein (alternativ lade die Extension aus dem TER).
- Installiere die Extension im Typo3 Backend.
- In dem Ordner `Frontend users and groups` füge eine neue Benutzergruppe hinzu ("BetatextUser").
- Erzeuge einen Neuen Ordner im Backend und nenne ihn z.B. "Betatext User".
- Lege dort einen neuen Benutzer an: `Username=Foo`, `password=Bar` und gib ihm die Gruppe, die zuvor angelegt wurde.
- Richte eine Rewrite-Rule in htaccess ein:  
	siehe `doc/.htaccess.dist`  	
	`RewriteRule rest\.php(/.*)$ index.php?eID=bbt&route=$1 [QSA,L,PT]`
- Installiere/aktiviere die Extension `saltedpasswords`
- Installiere/aktiviere die Extension `realurl`
- Wähle eine Seite aus, die mit Betatext kommentiert werden soll und kreuze dort für die rechte Spalte unter `Access -> Visibility -> Content Element` "Disable" an (damit auf der rechten Seite genug Platz für die Kommentare ist).
- In "Edit Page" schalte unter `General` den Page Type auf "betatext" und schalte unter dem Reiter `betatext` "commentable text" ein.
- Jetzt sollte sich eine Textstelle mit dem Testuser "Foo" kommentieren lassen.
- Passe ggf. das CSS (oder SCSS) und die dazugehörigen Grafiken im Ordner `we_betatext/template` an.
- Für die Benutzeranmeldung, installiere eine passende Extension, z.B. `sr_feuser_register`.
- Stelle im Extension Manager für Betatext die Konfiguration ein.
	- `[defaultLogo]` Standard-Logo der User wenn, kein benutzerdefiniertes eingestellt wurde.
	- `[dokType]` Der doktype der kommentierbaren Seiten.
	- `[groupID]` Benutzergruppen-ID der Nutzer (die ID von "BetatextUser" in `Frontend users and groups`)
	- `[userPID]` Parent-IDs der erlaubten Nutzer (ID des Ordners, in dem die User abgelegt werden)
	- `[url_registration]` Diese URL wird aufgerufen, wenn man in Betatext den Link "Noch nicht registriert?" anklickt.
	- `[url_pwforgot]` Diese URL wird aufgerufen, wenn man in Betatext den Link "Passwort vergessen?" anklickt.
	- `[url_edit]` Auf dieser Seite kann ein Benutzer seine Daten ändern.
	- `[infomail_from]` Absender E-Mail-Adresse von Kommentarbenachrichtigungen.
	- `[infomail_to]` Empfänger E-Mail-Adresse von Kommentarbenachrichtigungen für Redakteure. Ermöglichst die Sichtung und ggf. Löschung des Kommentars.
	- `[authhash_salt]` Zeichenkette zum salzen der Authentifizierungs-Hashes der Kommentarbenachrichtigungen: Am besten zufällig generiert.

		**Nach einmaligem Setzen nicht mehr ändern!** Bestehende Benutzerpasswörter können mit dem falschen Salz nicht mehr erkannt werden.

## Hinweise ##

- Es gibt ein Serverseitiges Logfile in `we_betatext/lib/debug.log`.
- Es gibt ein Clientseitiges logging (Javascript Console), das in `we_betatext/app/appConfig.js` ausgeschaltet werden kann. Weiter lässt sich dort einstellen:
	- `REST` Welche URL die Extension verwenden soll (siehe auch: Rewrite-Rule).
	- `wordRegex` Regular Expression um einzenle Wörter zu identifizieren.
	- `readonly` Selektor für das nur-Lesen von Seiten, bei denen kein Betatext mehr aktiviert ist (siehe weiter unten).
	- `limits` Länge eines gültigen Kommentars.
- Schaltet man im Reiter `betatext` "commentable text" wieder aus, so kann man keine neuen Kommentare auf der Seite mehr verfassen oder bewerten aber alte anschauen.