Nucleus CMS Benutzerhandbuch (v3.2)

Übersetzt von Christian Breker

Hinweis:

Vorwort

Übersetzungen verursachen einiges an Arbeit, aus diesem Grund wurden nur die wichtigsten Teile übersetzt. Solltest Du die deutsche Nucleus CMS Übersetzung unterstützen wollen, kontaktiere mich. Hilfe ist stets willkommen!

Es haben sich sicherlich (trotz Kontrolle) Tippfehler eingeschlichen. Sollte einer gefunden werden, so wäre ich über eine Benachrichtigung dankbar. Dies hilft die Qualität dieser Distribution weiter zu erhöhen. Hinweise können auf der Projektseite hinterlassen werden, oder direkt über meine Webseite an mich geschickt werden.

Von diesem Programm wurden die wesentlichsten Teile übersetzt, so sind z.B. Kommentare im Quellcode noch in englisch, da dies die meisten Benutzer nicht interessieren wird. Eine genaue Liste der Übersetzungen ist hier einsehbar.

Inhalt

Über Nucleus zurück nach oben

Nucleus ist ein Content Management System (CMS): eine kraftvolle Kombination aus PHP Skripten, die erlauben einen oder mehrere Weblogs zu betreiben. Eine kurze Zusammenfassung der wichtigsten Features:

Anforderungen von Nucleus: (ob der Server den Anforderungen entspricht, kann beim Administrator erfragt werden)

Nucleus ist für Anwender gedacht, die sowohl Optimierungsmöglichkeiten nutzen möchten als auch die volle Kontrolle über ihre Seite wünschen. Für jene, die auf möglichst einfachem Weg eine Seite aufzusetzen möchten, oder die gar kein HTML beherrschen, bieten sich einfachere Angebote an, wie z.B. Blogger.

Lizenz zurück nach oben

Aus rechtlichen Gründen kann der folgende Text nicht übersetzt werden:

Nucleus: PHP/MySQL Weblog CMS (http://nucleuscms.org/)
Copyright (C) 2002-2005 The Nucleus Group

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

Your possession of this software signifies that you agree to these terms. Please delete your copy of this software if you don't agree to these terms.



In dieser Software sollte eine Kopie der GNU General Public License erhalten sein; wenn nicht, kann sie unter der folgenden Adresse bezogen werden: Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

Installation zurück nach oben

Hinweis: Handelt es sich lediglich um ein Upgrade, solltest Du die Upgrade Anleitung (englisch) auf der Nucleus Webseite beachten.

Die Installation von Nucleus erfordert ein paar Schritte:

1. Entpacken

Alle Dateien werden in ein Verzeichnis auf dem lokalen Computer entpackt. Es ist darauf zu achten, dass die Verzeichnissstruktur mit entpackt wird (* steht für diverse Dateien):

/*                           (wichtige Dateien für die Seite)
/nucleus/*                   (wichtige Dateien für das Administrationsinterface)
/nucleus/javascript/*        (unterstützende Javascript Skripts)
/nucleus/libs/*              (Nucleus Kern Dateien)
/nucleus/language/*          (Sprachunterstützung)
/nucleus/plugins/*           (Plugin Verzeichnis)
/nucleus/xmlrpc/*            (XML-RPC Interface)
/nucleus/documentation/*     (Dokumentation + Administrationshilfe)
/nucleus/styles/*            (Stylesheets für die Dokumentation & das Administrationsinterface)
/nucleus/forms/*             (Vorgaben für Kommentarformulare etc.)
/extra/*                     (Extras, z.B. benötigte Dateien um Fancy URLs zu aktivieren)
/skins/*                     (Skins Berzeichnis [importierte Skins landen hier])
/media/*                     (Verzeichnis der Mediabibliothek [leer])

2. Dateien uploaden

Alle Dateien müssen auf den Server hochgeladen werden. Es muss sichergestellt sein, dass alle PHP Dateien im ASCII Modus hochgeladen werden, da ansonsten Fehler auftreten könnten!

Optional:

  1. Um die Installation noch einfacher zu machen, können die Dateirechte von config.php auf 666 gesetzt werden. So kann das Installationsskript die Datei automatisch aktualisieren und es muss nicht manuell geschehen. (Kurze Anleitung um Dateirechte zu ändern)
  2. Sofern später der Datei upload genutzt werden soll, benötigt das /media/ Verzeichnis eine Schreibberechtigung. Dies ist notwendig, damit PHP hochgeladene Dateien in das Verzeichnis schreiben kann. Das Verzeichnis sollte die Rechte 777 besitzen. (Kurze Anleitung um Dateirechte zu ändern). Sollte ein Root Zugriff vorhanden sein, kann das Verzeichnis chgrped zum Benutzer werden, der den httpd Prozess ausführt (normalerweise httpd oder nobody, dann einfach das Verzeichnis mit chmod 775 versehen).
  3. Wenn das SkinFiles Plugin benutzt werden soll, um Dateien zu bearbeiten, müssen alle Dateien und Verzeichnisse des /skins/ Verzeichnisses weitere Recht erhalten. Um Dateien bearbeiten zu können, müssen die Rechte auf 666 gesetzt werden (Kurze Anleitung um Dateirechte zu ändern). Um neue Dateien oder Verzeichnisse zu erstellen, sollte das Verzeichnis über die Rechte 777 verfügen.

3. install.php ausführen

Öffne mit Deinem Webbrowser die u.g. URL, ändere deineseite und deinverzeichnis entsprechend.

http://www.deineseite.com/deinverzeichnis/install.php

Das Installationsskript wird einige Informationen abfragen und das Meiste der Installation selbstständig ausführen. Wenn alles gelungen ist, wird install.php weitere Anweisungen geben. (Einige Dateien müssen manuell gelöscht werden.)

Merke: Sollte nach dem Öffnen von install.php im Browser ein entsprechender Text erscheinen oder ein Download von 'install.php' gestartet werden, unterstützt der Webbrowser kein PHP - Nucleus kann dort also nicht ausgeführt werden.

4. Fertig!

Du solltest nun die Seite http://deineseite.com/weblog/ (also das Nucleus Hauptverzeichnis) besuchen können.

Sicherheitsaspekte zurück nach oben

mySQL Passwörter

Da Nucleus via einem PHP Skript Verbindung zu einer mySQL Datenbank aufbauen muss, ist das Passwort in einer PHP Datei gespeichert. Auf Systemen mit mehreren Benutzern kann dies ein unumgehbares Sicherheitsproblem darstellen: Auf einigen Systemen können andere Benutzer diese Informationen auslesen. In diesen Fällen empfiehlt es sich den Systemadministrator zu kontaktieren, um herauszufinden, wie sicher es ist, diese Informationen in einem PHP Skript zu speichern.

Das o.g. Problem ist unter allen PHP Skripten, die zu einer Datenbank eine Verbindung aufbauen müssen, verbreitet. Als Benutzer kann man nichts dafür tun, um diese Dinge 100% sicher zu machen. Man sollte sich aber dennoch dieser potentiellen Gefahr bewusst sein.

Cookies

Nucleus benutzt Cookies, um Login Informationen von Benutzern zu speichern. Dies könnte ein Sicherheitsproblem sein, wenn die Cookies gestohlen werden. Das Passwort kann jedoch nicht aus dem Cookie ausgelesen werden (die im Cookie enthaltenen Daten bestehen aus dem Benutzernamen und einer zufällig generierten Zeichenkette). Es könnte immer einen Weg geben, das Cookie auf einem anderen Computer zu fälschen und sich somit einzuloggen.

Medienverzeichnis

Wenn der Datei upload aktiviert ist, müssen die Rechte des Medienverzeichnisses auf 777 gesetzt werden, was bedeutet das jeder auf diesem Server Dateien löschen/hinzufügen/... kann. Der Grund dafür liegt darin, dass PHP zumeist als httpd Benutzer läuft und dieser Benutzer entsprechende Rechte gegenüber dem Verzeichnis benötigt. Hier gibt es also ebenfalls keinen anderen Weg.

Performanceaspekte zurück nach oben

Im Unterschied zu anderen Weblog Skripten, generiert Nucleus keine statische Version von allen Gegenständen. Dies bedeutet, dass jedes mal, wenn eine Seite angefordert wird, der PHP Parser aufgerufen und auf die Datenbank zugegriffen wird, um die angeforderte Seite dynamisch zu generieren.

Für kleine Webseiten sollte dies kein Problem darstellen. Für Webseiten, die dutzende Zugriffe pro Sekunde haben, ist der Effekt auf die allg. Systemperformance nicht wirklich bekannt. Bis jetzt wurden allerdings keine Probleme von Nucleusbenutzern berichtet (wobei einige Nucleus für wirklich große Seiten benutzen, mit 30 oder mehr Weblogs in einer einzelnen Installation).

Was ist (nicht) erlaubt in Kommentaren? zurück nach oben

Nucleus ist mit einigen Regeln für Kommentare ausgestattet:

As for now, all of these rules and parameters are hardwired into the code.

XML-RPC Interface zurück nach oben

Die URL für das Nucleus XML-RPC Interface lautet:
http://www.deineseite.com/deinverzeichnis/nucleus/xmlrpc/server.php

XML-RPC ist ein Format für Aufrufe, die XML Nachrichten benutzen. Klingt komplex, aber ein XML-RPC Interface in eine Applikation zu integrieren, erlaubt anderen mit ihr zu kommunizieren.

Momentan werden drei APIs unterstützt: Blogger API, metaWeblog API und Movable Type API. Beispiele für Programme, welche diese Interfaces benutzen, sind w.Bloggar (Windows) oder Ecto (MacOS).

Die möglichen Aufrufe des Interfaces sind in der Entwicklungsdokumentation beschrieben, welche seperat heruntergeladen (englisch) oder online betrachtet (englisch) werden kann.

Fehlerbehebung (FAQ) zurück nach oben

Hier werden einige der häufigsten Probleme im Zusammenhang mit Nucleus beantwortet. Bevor man nach Hilfe fragt, sollte man dies lesen. In den meisten Fällen kann die Lösung des Problems hier gefunden werden.

Ich bekomme den Fehler: Cannot send headers. Headers already sent...
Dieses Problem wird meist durch Leerzeichen am Beginn oder am Ende der Datei config.php ausgelöst. Kontrolliere ob die Datei Leerzeichen vor <? oder nach dem Ende mit ?> enthält. Sollten dort welche sein, entferne sie. Das Problem kann auch mit Leerzeichen in der Sprachdatei oder einem der installierten Plugins zusammenhängen.
Wenn ich versuche install.php auszuführen werde ich gefragt, ob ich die Datei herunterladen möchte.
Der Server ist nicht konfiguriert, PHP Skripte zu unterstützen. Nucleus kann auf einem solchen System nicht installiert werden.
Wenn ich versuche meine Webseite zu besuchen bekomme ich einen 'Connection Error'. Warum?
Der Grund dieser Fehlernachricht liegt darin, dass Nucleus (aus welchem Grund auch immer) keine Verbindung mit der Datenbank aufbauen oder die Datenbank nicht auswählen kann. Ein möglicher Grund ist, dass die Login Informationen in config.php nicht stimmen; ein anderer ist, dass der mySQL Server momentan nicht erreichbar ist.
Meine Update Datei funktioniert nicht!
Die Dateirechte müssen korrekt gesetzt sein, damit die Datei funktionieren kann. Sie benötigt die Rechte 666 und die Verzeichnisse die Rechte 775. (Kurze Anleitung um Dateirechte zu ändern)
Ich wünsche nicht, dass das XML-RPC Interface erreichbar ist.
Das Verzeichnis xmlrpc/ kann ohne Probleme gelöscht werden.
Ich wünsche keinen RSS Feed.
Die Datei xml-rss.php (headlines.php) und 'xmlrss' (headlines) skin/template können gelöscht werden.

Bekannte Probleme zurück nach oben

Einige bekannte Probleme:

Autoren & Danksagungen zurück nach oben

Egal, mit wieviel Mühe es versucht wird, einige Menschen werden immer unbeabsichtigt übersehen werden.

Begründer

Code

Libraries etc.

Übersetzung von Nucleus in die deutsche Sprache

Danke!

Viele Danksagungen sollten auch an jene ergehen, die geholfen haben Nucleus zu dem zu machen, was es heute ist.