Plugins für phpCMS
 AutoKeyGen   MenuManager   csvImport   Sitemap 
Plugins für phpCMS
 
 
   Über csvImport 
   Download 
   Lizenz 
   Features 
   Planung 
   Voraussetzungen 
   Konfiguration 

Rate csvImport
at HotScripts.com
© 2001-2007, Patrick Müller 

Konfiguration von csvImport

Ladet zuerst die aktuelle Version von csvImport auf Euer System. Ihr findet eine gepackte ZIP-Datei auf der Seite Download.

Am besten entpackt Ihr die Dateien in ein neues Verzeichnis im Plugin-Verzeichnis Eures phpCMS-Systems. Ich habe das Verzeichnis hier bei mir "/csvimport" genannt.

Der Aufruf des Plugins erfolgt entweder im Template oder besser direkt in der Content-Datei, damit es nur bei Bedarf aufgerufen wird:

{PLUGIN FILE="/Pfad/csvimport.php" TYPE="STATIC"}

Nähere Informationen über den Einsatz von Plugins sind auf der phpCMS-Website erhältlich.


Innerhalb einer Content-Datei muß folgender Bereich definiert sein:

{CSVIMPORT}
<CSVIMPORT
 NAME="beispiel"
 CONTENT="/beispiel.csv"
 FIELDS="feld1,feld2"
 TEMPLATE="/beispiel.tpl">

Dabei ist es unerheblich, ob die Parameter in einer Zeile geschrieben wurde oder wie hier über mehrere Zeilen.

Daten- (CONTENT=) und Template-Datei (TEMPLATE=) müssen momentan mit absoluten Pfadangaben (vom Root der Website aus) versehen werden !

Folgende Parameter sind optional möglich:

ParameterBeispielDefaultBeschreibung
DOTAGSDOTAGS="ON"OFFJedes Feld der Tabelle steht als phpCMS-Tag zur Verfügung
HEADLINESHEADLINES="2"1Anzahl Zeilen der Überschrift
ALTERNATEALTERNATE="2"1Alternatives Template alle ALTERNATE Zeilen (Parameter wird nur benutzt falls >= 2)
GROUPLINESGROUPLINES="3"1Anzahl Zeilen pro Daten-Gruppe
CSVTEMPCSVTEMP="tabelle"Wert von NAMEName des Template-Bereiches
SEPARATORSEPARATOR="; ";Trennzeichen zwischen den Feldern der CSV-Datei

Ein CSV-Template könnte z.B. wie folgt aussehen:

{beispiel.PRE}
<!-- START beispiel -->
<TABLE>


{beispiel.HEAD}
<TR BGCOLOR="#EEEEEE">
	<TD><STRONG>{Feld1}</STRONG></TD>
	<TD><STRONG>{Feld2}</STRONG></TD>
</TR>


{beispiel.NORMAL}
<TR>
	<TD>{Feld1}</TD>
	<TD>{Feld2}</TD>
</TR>


{beispiel.ALTERNATE}
<TR bgcolor="#DDFFDD">
	<TD>{Feld1}</TD>
	<TD>{Feld2}</TD>
</TR>


{beispiel.PAST}
</TABLE>
<!-- END beispiel -->


Das Plugin erzeugt nun anhand des Parameters NAME ein weiteres phpCMS-Tag mit den erzeugten Daten, das frei im Content oder einem Template plaziert werden kann:

<CSVIMPORT_beispiel>


Ab der Version 1.0.0 liegen dem Archiv DEMO-Files bei, damit Ihr Eure Daten leichter importieren könnt.

Default-Einstellungen von csvImport

Das Plugin kann bei jeder Benutzung in der Content-Datei individuell eingestellt bzw. konfiguriert werden. Änderungen an den Default-Werten sind nicht zwingend notwendig.

In der Datei "csvimport.php" findet Ihr am Anfang der Datei einen Abschnitt der mit dem Kommentar
"<-- Default-Konfiguration START -->" beginnt.

Danach folgen einige Variablen-Definitionen, die hier im Detail erklärt werden.
Abgeschlossen wird der Konfigurations-Bereich mit
"<-- Default-Konfiguration END -->".

Normalerweise solltet das Plugin ohne Änderung dieser Werte funktionieren:

VariableDefault-WertBeschreibung
$default_text"&nbsp;"Default-Text if empty field
$doReplTags"OFF"generate phpCMS-tags for each field in the data-file
$separator";"characters-combination between the extracted words in the meta-tags
$headlines"1"no. of headlines
$grouplines"1"no. of lines for each group
$alternate"1"use alternative template every x line (if greater than "1")
$csvtemp""name of template
$maxLineSize"1000"maximum number of characters in a csv-line

Alle weiteren Werte bitte unverändert lassen!