====== Volkszaehler in XAMPP unter Windows installieren ======


===== Installtation der Komponenten =====
=== I. XAMPP ===
Xampp nach Anleitung installieren (es geht auch die Version ohne Installer)
http://www.apachefriends.org/de/xampp-windows.html

=== II. volkszaehler.org Skripte ===
volkszaehler.org Skripte aus dem Git herunterladen (https://github.com/volkszaehler/volkszaehler.org) und den "volkszaehler"-Ordner aus dem Archiv in das Verzeichnis
<code>xampp\htdocs\ </code>
kopieren.
	
=== III. Benötigte Module ===

Composer für Windows von getcomposer.org installieren (http://getcomposer.org/Composer-Setup.exe)

In das Volkszaehler Verzeichnis wechseln
<code>cd xampp\htdocs\volkszaehler</code> 

Ahängigkeiten laden und installieren (v.a. Doctrine)
<code>
composer install
</code>
===== Konfiguration =====

=== Middleware ===


  * Datei config.dist.yaml kopieren und zu config.yaml kopieren. Sie befindet sich hier:
 <code>xampp\htdocs\volkszaehler\etc\</code>

  * Folgende Anpassungen vornehmen
<code>
  host: 127.0.0.1
  port: 3306
  user: vz
  password: <shhh!>
  dbname: volkszaehler
</code>

=== Datenbank ===

== Anlegen ==
  * Datenbank-User in phpmyAdmin anlegen:
<code>
    Home -> "Rechte" -> "Neuen Benutzer hinzufügen"
        Benutzername: vz
        Host: localhost
        Passwort: <shhh!>
        keine globalen Rechte vergeben!
        -> ok
</code>

  * Datenbank in phpMyAdmin anlegen:
<code>
    Home -> "Datenbank anlegen", Name: "volkszaehler" -> "Anlegen"
</code>


== Struktur erzeugen ==
  * Das php-Verzeichnis (z.B. C:\xampp\php) in den Umgebungsvariablen dem Suchpfad hinzufügen
<code>Systemeigenschaften -> Tab: Erweiter -> KLick auf "Umgebungsvariablen"  -> Unter "Systemvariablen" Doppelklick auf "Path" 
-> Unter "Wert der Variablen" am Ende den Pfad mit Semikolon getrennt einfügen (hier: ;C:\xampp\php)</code>
[dieser Schritt kann nach dem erstellen der Struktur wieder rückgängig gemacht werden]

  *  Windows-Konsole öffnen (cmd)
In das volkszaehler-Verzeichnis in der xampp-Installation wechseln
<code>cd xampp\htdocs\volkszeahler</code>

  * Struktur erstellen:
<code>php bin/doctrine orm:schema-tool:create --dump-sql > misc/sql/mysql.sql</code>

  * In der erzeugten mysql.sql die Zeile 
<code>ATTENTION: This operation should not be executed in an production enviroment.</code>
entfernen.

== Import und Rechte vergeben ==
Im phpAdmin-Webinterface:

  * Tabellen in phpMyAdmin anlegen:
    Datenbank -> "volkszaehler" auswählen (ggf. phpmyadmin neu laden, falls die neue DB noch nicht angezeigt wird)

  * Erzeugte Struktur importieren: 
      "Importieren" aus misc/sql/mysql.sql

  * Demoinhalte importieren:
Tabelle "entities" auswählen (unbedingt zuerst diese importieren!)
"Importieren"; das Gleiche mit "properties" und "data"

  * Rechte setzen:

Home -> Datenbank -> "mysql", Tabelle "tables_priv":
"Einfügen": 
<code>
        Host: "localhost"
        Db: "volkszaehler"
        User: "vz"
        Table_name: "data" (anschließend das Gleiche mit "entities", "entities_in_aggregator", "properties", "tokens"
        Table_priv: "select", "update" und "insert"
Oder:
Home -> Rechte -> Benutzer "vz" auswählen -> unter "Datenbankspezifische Rechte" volkszaehler auswählen 
-> Unter "Daten" update, insert und select markieren 
-> unter "Administration" GRAND markieren
</code>


Aufruf des Volkszahler-WebFontends über: 
http://localhost/volkszaehler/htdocs