Installieren

(Übersetzen)

Die aktuelle (stable) Version von phpwcms finden Sie im Projekt-Repository. Wählen Sie das komprimiertes Archiv aus. Verwenden Sie einen Webbrowser zum Herunterladen des Installationspakets auf Ihre Festplatte. Wenn Sie einen Shell-Zugriff auf Linux-oder Mac OS X haben, können Sie “wget” zum direkten Download auf den Web-Server verwenden.

Die letzte Version (Release) ist immer hier verfügbar:
Stabile Entwicklerversion (Empfohlen)
→ Committed Changes → to
→→ Docu: DEV - Version ZIP Format

<note tip>Ich empfehle allerdings immer die Docu: DEV - Version ZIP Format zu verwenden, da diese Version ebenso als stabil zu betrachten ist und die letzten Neuerungen beinhaltet. </note>

Nach dem Download entpacken Sie das Archiv in ein neues Verzeichnis. Geben sie darauf acht, dass auch alle Unterverzeichnisse autom. angelegt werden. Wenn Sie keine Entpacksoftware unter Windows installiert haben, versuchen Sie z.B. totalcommander, FileZilla oder PowerArchiver. Der Inhalt sollte wie folgt aussehen:

Screenshot (TotalCommander).

Öffnen Sie nun eine FTP-Verbindung zu Ihrem Webspace. Denken sie darüber nach, an welchem Ort Sie phpwcms online stellen möchten. Sie können phpwcms in einem beliebigen Ordner auf Ihrem Webspace setzen - oder legen Sie das System direkt in das Websever Wurzelverzeichnis. Kopieren Sie die komplette Struktur unkomprimiert via FTP auf Ihren Webserver. Wenn dies geschehen ist, müssen Sie die Zugriffsrechte für spezielle Dateien und Ordner überprüfen.

• 777 Verzeichnisse
  • content
  • content/ads
  • content/form
  • content/gt
  • content/images
  • content/pages
  • content/rss
  • content/tmp
  • filearchive
  • filearchive/can_be_deleted
  • upload
  • template/template_lang
• 666 Dateien
  • setup/setup.conf.inc.php
  • config/phpwcms/conf.indexpage.inc.php
  • template/inc_css/frontend.css
  • template/inc_default/startup.php

Alle anderen oben genannten Dateien können auf 644, Verzeichnisse auf 755 gesetzt werden. Sollte das System so nicht laufen hilft es manchmal die Rechte für die Verzeichnisse template und inc_css auf 766 zu setzen. Wenn Sie weitere Probleme beim Zugriff haben, versuchen Sie alle Dateien und Verzeichnisse auf 777 zu setzen (nicht empfohlen).

Übersetzen

Nach dem erfolgreichen Hochladen der phpwcms-Installationsdateien auf den Webserver wird der Installationsprozess über den folgenden Link gestartet:

http://www.example.com/path_2_phpwcms/setup/index.php

On top of the setup index page is an info field that gives information to the system, server software, PHP version and the path in which phpwcms is installed. If you have a PHP version <4.2.1 you should not continue – recommend PHP version >4.3.0. To continue you have to agree the GPL licence – then click button to go to step 1 of phpwcms setup script.

Info: Inside the setup folder is a file “setup.conf.inc.php”. All setup value will be stored there. You can also edit this file manually. Look for “phpwcms_init.sql” to setup required db tables manually.

Insert your MySQL database infos like the host (default: localhost) or IP address of the MySQL server, your MySQL username/password and db name. Attention! The setup process can create the phpwcms tables only and NOT the MySQL table itself. If you want to separate phpwcms database tables from other tables inside your database you can define a table prefix. This is not really neccessary because phpwcms table names ever start with “phpwcms_”. The prefix makes a table named like “myprefix” + “_” + “phpwcms_”. If your MySQL server supports persistent database connection let the correspinding mark checked – this speeds up the db queries. Large providers may disallow this feature. In this case uncheck mark “use persistent db con”.

If you install phpwcms for the first time and want to let the setup process create all db tables mark “create all db tables” checked.

Then click “send db data”. If everything is OK let's go on…

In normal case you do not have to fill in difficult things here. Insert the base URL ONLY in field site name. Complete the base URL with an ending slash ”/”. Attention! Do not add any additional path info like …mydomain.com/phpwcms/”. This will be defined later.

Fill in the login information for admin user and admin email address. phpwcms comes without any predefined user login information. You have define yourself. Do not forget to check “ceate admin account” if setup script should create the given account for you.

There is not so many to say about here. Read any field info attentively. You can rename default directories to whatever you want. Attention! Do not add any starting or ending slash ”/” to phpwcms path values.

To use a directory outside phpwcms root use path names like this: ”../dir_outside”.

There is a additional directory not listed here. It is “picture”. This is the base dir for the {IMAGE.. } replacement tag. It can not be renamed at the moment. So be sure it exists inside the phpwcms root directory.

The most important values are “content width” and “preview image”. The content width value is important for rendering image lists. It adjusts the image width. That ensures that your content is rendered very well. The preview image value defines maximum width and height of preview images. Remember that preview images will displayed if an image is click zoomable. If this is to large your site visitor may have problems. This often results in big image file sizes too.

Step 5 is to verify defined path values. Check that possibly every directory has OK. Maybe you can ignore RED alerts if you have set access rights as described above. I will test this. If you are unsure set every listed directories to usermode 777. You will get error messages very fast if there is a problem

Download the finished configuration file ”/setup/setup.conf.inc.php” and put this into ”/config/phpwcms/*”. If neccessary rename the config file from “setup.conf.inc.php” → “conf.inc.php”.

If you have successfully adjusted phpwcms delete the setup folder. Make a backup of your current “conf.inc.php” file. It is possible to edit this file manually.

Sometimes the $_SERVER[“DOCUMENT_ROOT”] var is not available in PHP under Microsoft Internet Information Server. If so you have to insert the root value manually in the conf.inc.php. Do it like this:

$_SERVER["DOCUMENT_ROOT"] = '/home/where_my_web_root_is';