Hoffi prsentiert
einen berarbeiteten Kunena Converter, der Daten aus dem Agora-Forum *direkt* 
in das Kunena 1.6 Forum kopiert.
Dabei wurde das Problem mit den doppelten ersten Beitrgen jedes Themas gefixt, 
die bernahme der Topic-Icons (so gut wie mglich) sowie der Abonnements
eingebaut, die bernahme der Avatare neben .png auf .jpg und .gif erweitert,
alles komplett von Kunena 1.5 (jos_fb_* Tabellen) auf Kunena 1.6 
(jos_kunena_* Tabellen) umgestellt, sowie zahlreiche Stabilisierungen und 
Verbesserungen eingebaut.

Hinweis zu groen Foren
-----------------------
Dieser Konverter wurde komplett berarbeitet. Dabei wurden die meisten Schleifen
im PHP-Code elimimniert und in die SQL-Abfragen verlagert.
Dies fhrt zu einer Beschleunigung, Hauptgrund war aber die Aussage im
PHP-Handbuch, dass Zeiten fr SQL- und Dateifunktionen NICHT beim PHP-Timeout
mitzhlen. Allerdings musste ich feststellen, dass sie bei meinem xampp sehr
wohl mitzhlen. Ich kann also leider nicht verprechen, dass sich groe Foren
nun problemlos importieren lassen.
Allerdings konnte ich ein Testforum mit ~70000 Beitrgen in ca. 40 Sekunden
importieren. Die Vorgngerversion hatte nach 60 Sekunden gerade mal 9500
Themen mit jeweils dem ersten Beitrag importiert.

Hinweise zu Kunena selbst
-------------------------
Mir ist aufgefallen, dass in Kunena (nicht im Konverter) teilweise die Tabellen
mit "jos_" angesprochen werden, statt mit "#_". Das bedeutet, dass es zu 
Problemen kommt, wenn in einer Datenbank die Tabellen einen anderen Prfix haben
(eingestellt in Joomla Global Configuration -> Server -> Database Settings ->
 Database Prefix).

Installation
------------
1. Backup der Website incl. Datenbank!
   (Es werden Tabellen geleert, Dateien berschrieben)
2. Bei Bedarf Lschen aller Tabellen jos_fb_* (wurden von Kunena 1.5 und dem
   Original-Konverter verwendet, sind nun berflssig)
3. Original Kunena Konverter sowie Kunena 1.6 installieren.
   (falls noch nicht geschehen)
4. Meine Datei kunenaconverter.php in einem Texteditor ffnen und den Block
   SETTINGS prfen/anpassen, ggf. auch das Topic-Icon-Mapping (Zeilen 420ff).
5. Datei speichern und nach
     <Joomla!-Root>/administrator/components/com_kunenaconverters/models/
   kopieren/hochladen.
6. je nach Laune Datei kunenaconverters.xml nach
     <Joomla!-Root>/administrator/components/com_kunenaconverters/
   kopieren/hochladen (zeigt dann Version 1.6 statt 1.5).
7. Im Backend die Kompoenente Kunena Converters whlen.
8. Auf das Agora-Icon klicken und warten, bis alles importiert und die Seite
   neu geladen ist.
9. Im Backend ins Kunena Control Panel gehen und die Rechtevergabe
   prfen/anpassen sowie ggf. weitere Einstellungen vornehmen.
A. Falls es Umfragen im Agora-Forum gab, sollte noch der Menpunkt
   "Recount Category Statistics" angewhlt werden.
B. Im Front-end ins Kunena-Forum gehen und alles berprfen
C. Agora Forum deinstallieren (Achtung! evtl. Attachments retten und danach 
   wiederherstellen, s. <Joomla!-Root>/components/com_agora/img/members/)
D. Die Daumen drcken, dass Kunena nicht auch kostenpflichtig wird!

Was geht?
---------
+ sauberes Wegputzen der Kunena DB Tabellen (alles, was mit Benutzern und
  Beitrgen zu tun hat)
+ wiederholtes Ausfhren ohne Probleme (es gehen natrlich jedesmal alle in 
  Kunena selbst gemachten nderungen/Posts verloren)
+ Import der Benutzer incl. Avatar (.png|.jpg|.gif-Datei, wird nach
  <Joomla!-Root>/media/kunena/avatars/users/ kopiert), Signatur, Abos etc.
+ Import unbekannter Benutzer (mit id 0) - diese werden als "Guest" angezeigt
+ Import der Kategorien und Foren
+ Import der Themen und Beitrge (incl. Closed- und Sticky-Flags)
+ optional wird versucht, alle importierten Kategorien und Foren auf
  registrierte Benutzer zu beschrnken (in php-Datei konfigurierbar)
+ es wird versucht, die Topic-Icons mglichst gut zu mappen
+ optionale bernahme der Agora Smileys (in php-Datei konfigurierbar)
  Dazu muss in der php-Datei der IMPORT_SMILEYS_MODE eingestellt werden.
  0: keine bernahme,
  1: unbekannte hinzufgen, aber keine Dateien berschreiben,
  2: unbekannte hinzufgen und dabei Dateien (der unbekannten) berschreiben,
  3: alle Smileys lschen und durch die von Agora ersetzen
     (berflssige Dateien werden aber nicht gelscht)
+ und was ich einfach vergesen habe zu erwhnen ;)

Was geht nicht?
---------------
- Umfragen werden nicht importiert
- Userprofil: Geburtsdatum wird nicht bernommen
- User Bans werden nicht bernommen
- Attachments werden nicht umkopiert, knnten also im com_agora-Baum liegen
- "alte" Attachments in Kunena werden nicht gelscht
- "alte" Avatare werden nicht gelscht, aber bei Bedarf berschrieben
- keine bernahme von Gruppen und damit verbundenen Rechten 
- keine bernahme von Moderatoren(rollen)
- keine bernahme des "gelesen"-Status, alle Themen erscheinen somit als NEU
- Agora kommt bei Polls mit seiner Topic-Zhlung durcheinander - dies wird
  *exakt* nach Kunena kopiert. Deshalb sollte man danach im
  Kunena Control Panel "Recount Category Statistics" ausfhren.
- und was ich einfach bersehen habe ;)

---
Hoffi, Januar 2011
