Andreas
09.08.2007, 17:41
Was sind Produkte/Add-ons?
Produkte sind ein mit vBulletin 3.5 eingeführtes Konzept zur einfachen Erweiterung der Funktionalität von vBulletin.
Produkte vereinen Objekte die viele vBulletin Modifikationen nutzen
Achtung: Mit vBulletin 3.6.6 wurde die Bezeichnung Produkte durch Add-ons ersetzt. Dieses sowie etliche weitere Tutorials und Installationsanleitungen verwenden die ältere Bezeichnung Produkt.
Bitte beachten Sie dies bei der Bezeichnung von Menüpunkten, etc. (z.B. Add-ons & Plugins anstatt Produkte & Plugins)
Was sind die Vorteile von Produkten gegenüber Plugins
Plugins enthalten nur PHP Code. Besteht nun eine Modifikation aus mehreren Plugins, so müsste man z.B. bei Problemen jedes einzeln deaktivieren.
Produkte hingegen sind eine Einheit - wenn man ein Produkt deaktiviert so werden alle Plugins dieses Produkts deaktiviert.
Auch können Produkte viele weitere Bestandteile enthalten.
Was enhtält ein Produkt?
Ein Produkt besteht zunächst einmal nur aus einer ID , einer Bezeichnung und einer Versionsnummer - alle weiteren Bestandteile sind optional.
Man kann zustzälich noch eine Beschreibung eingeben, ab vBulletin 3.6 auch URLs für das Produkt (Support & Versions-Check).
Folgende Objekte können mit Produkten verknüpft werden;
Plugins (siehe eigene Anleitung)
Templates
Phrasen
Einstellungen
In vBulletin 3.6 darüber hinaus
Administrator-Hilfe
Frontend-Hilfe (FAQ)
Cronjobs
Verfügt ein Produkt noch über weitere Eigenschaften?
Ein Produkt kann auch über Installations-/Deinstallationscodes verfügen die beim Import bzw. Deinstallieren eines Produkts ausgeführt werden. Hiermit kann man z.B. nötige Tabellen erstellen/löschen oder Datenbankänderungen durchführen.
Somit erspart man sich in vielen Fällen eigene Installationsprogramme.
Achtung: Eine Benutzer-Interatkion ist hierbei nicht möglich!
Wenn dies nötig ist muss man weiterhin auf eigene Installationsprogramme zurückgreifen
vBulletin 3.6 bietet darübere hinaus die Möglichkeit Abähngigkeiten, z.B. von einer bestimmten mySQL-Version oder anderen Produkten zu definieren.
Diese werden bann bei Installation, Deinstallation, etc. automatisch geprüft und die Aktion ggf. abgewiesen wenn die Bedingungen nicht erfüllt sind.
Wie erstelle ich ein Produkt?
Wer selbst Produkte erstellen möchte muss sein Board im Debug-Modus betreiben.
Hierzu gibt es die eine Einstellung in der Datei config.php im Verzeichnis includes:
PHP:
----------
Der Inhalt dieses Abschnitts ist nur für Lizenznehmer sichtbar, Sie werden derzeit jedoch nicht als Lizenzinhaber erkannt.<br />
<br />
Bitte öffnen Sie den <a href="http://members.vbulletin-germany.com/membersupport_priority.php">Kundenbereich</a>, tragen Sie Ihre E-Mail-Adresse ein, mit der Sie sich hier registriert haben und aktivieren Sie die Lizenzüberprüfung für http://www.vbulletin-germany.org.
----------
Dies aktiviert den Debug-Modus lediglich im Administrator-Kontrollzentrum, was im Regelfall ausreichend ist.
Bevor man einem Produkt weitere Bestandteile hinzufügen kann muss man dieses erstellen:
ACP / Plugins & Produkte / Produkte verwalten
Hier klickt man unten den Link Produkt importieren/hinzufügen und fügt auf der folgenden Seite ein Produkt hinzu.
Produkt-ID
Dies ist ein beliebiger, bis zu 25 Zeichen langer Bezeichner (keine Sonderzeichen, der Präfix vb ist für die Verwendung durch Jelsoft reserviert) für das Produkt.
Jeder Bezeichner darf nur 1x vergeben werden!
Titel
Hier wird die Bezeichnung das zu erstellenden Produkts eingegeben
Version
Hier muss die Versionsnummer des Produkts eingegeben werden.
Dies muss folgendem Schema entsprechen:
a[.b.c.d] [Alpha|Beta|Gamma|RC|Release Candiate z]
Also z.B. 3.4.0.1 Beta 7 oder 1.0.4 oder 3.5 RC 2
URL zum Produkt (nur vBulletin 3.6)
Hier kann eine Infor-Seite zum Produkt angegeben werden
URL zum Überprüfen der Version
Hiere kann eine URL angegeben werden die jeweils die aktuelle Versionsnummer des Produkts zurückliefert
Zur Erstellung der einzelnen Bestandteile:
Plugins
Siehe eigene Anleitung
Phrasen
Hierzu erstellt man in der entsprechenden Phrasengruppe eine neue Phrase in der MASTER Sprache und wählt dabei das entsprechende Produkt aus.
Es können auch eigene Phrasengruppen verwendet werden; deren Erstellung behandelt eine eigene Anleitung
Templates
Hierzu erstellt man die entsprechenden Templates im MASTER Style und wählt das entsprechende Produkt aus
Admin-Hilfe, Frontend-Hilfe, Einstellungen & Cronjobs (nur vBulletin 3.6)
Hierbei ist es wichtig vBulletin Standard = Ja zu setzen
Was ist mit Template-Änderungen?
Es gibt derzeit keine Möglichkeit um Template-Änderungen über Produkte zu realisieren.
Hierzu verfasst man am besten eine Anleitung (Suche ..., Ersetze ...) mit Hilfe derer der Nutzer seine Templates entsprechend ändern kann.
Man kann mit Hilfe von Template-Conditionals überprüfen ob ein bestimmtes Produkt aktiv ist und so dessen GUI nur dann anzeigen wenn es aktiv ist:
CODE:
----------
Der Inhalt dieses Abschnitts ist nur für Lizenznehmer sichtbar, Sie werden derzeit jedoch nicht als Lizenzinhaber erkannt.<br />
<br />
Bitte öffnen Sie den <a href="http://members.vbulletin-germany.com/membersupport_priority.php">Kundenbereich</a>, tragen Sie Ihre E-Mail-Adresse ein, mit der Sie sich hier registriert haben und aktivieren Sie die Lizenzüberprüfung für http://www.vbulletin-germany.org.
----------
Mein Produkt benötigt eigene Tabellen oder muss vorhandene ändern, wie gehe ich vor?
Produkte können über Installations-/Deinstallations-Code verfügen.
Für jede Version eiens Produkts kann dabei ein eigener Satz Codes erstellen werden.
Das Plugin-System wird dann die nötigen Codes bei Installation bzw. Deinstallation ausführen.
Um einen Installations-Deinstallationscode hinzuzufügen ruft man Produkte & Plugins, Produkte verwalten auf.
In diesem Fenster wählt man im Dropdown des jeweiligen Produkts den Punkt Bearbeiten.
In dem daraufhin erscheinenden Dialogfenster kann man untern bei Neuen Installations/Deinstallations-Code hinzufügen einen entsprechenden Code eingeben.
Beispiel für die Erstellung einer neuen Tabelle:
PHP:
----------
Der Inhalt dieses Abschnitts ist nur für Lizenznehmer sichtbar, Sie werden derzeit jedoch nicht als Lizenzinhaber erkannt.<br />
<br />
Bitte öffnen Sie den <a href="http://members.vbulletin-germany.com/membersupport_priority.php">Kundenbereich</a>, tragen Sie Ihre E-Mail-Adresse ein, mit der Sie sich hier registriert haben und aktivieren Sie die Lizenzüberprüfung für http://www.vbulletin-germany.org.
----------
Beispiel für das ändern der User-Tabelle:
PHP:
----------
Der Inhalt dieses Abschnitts ist nur für Lizenznehmer sichtbar, Sie werden derzeit jedoch nicht als Lizenzinhaber erkannt.<br />
<br />
Bitte öffnen Sie den <a href="http://members.vbulletin-germany.com/membersupport_priority.php">Kundenbereich</a>, tragen Sie Ihre E-Mail-Adresse ein, mit der Sie sich hier registriert haben und aktivieren Sie die Lizenzüberprüfung für http://www.vbulletin-germany.org.
----------
Der letzte Parameter beschreibt ob ein bereits vorhandenes Feld gleichen Names überschrieben werden soll (true) oder nicht (false).
Für weitergehende Funktionen, sieh Datei class_dbalter.php im Verzeichnis includes
Mein Produkt benötigt bestimmte Versionen von mySQL, PHP, vBulletin oder eines anderen Produkts. Wie stelle ich dies sicher?
vBulletin bietet ab Version 3.6 die Möglichkeit entsprechende Abhängigkeiten zu definieren welche dann automatisch geprüft und ggf. Aktionen abgelehnt werden.
Um eine solche Abhängigkeit zu definieren ruft wie oben Produkt bearbeiten auf und gibt dort die entsprechenden abhängigkeiten ein.
Wie gebe ich ein von mir erstelles Produkt weiter?
Hierzu wählt man Unter Produkte & Plugins, Produkte verwalten im Dropdown des jeweiligen Produkts den Punkt Exportieren
Dabei wird eine XML-Datei mit der Definition des Produks und aller seiner Bestandteile (Plugins, etc.) erstellt.
Wie installiere ich ein Produkt?
Auch wieder über Produkte & Plugins, Produkte verwalten indem man unten den Link Produkt importieren/hinzufügen anklickt.
Im darauffolgenden Formular wählt man die XML-Datei aus.
Beim Update eines Produkts ist hierbei zu beachten dass man das Kontrollkästchen Überschreiben erlauben aktiviert.
Produkte sind ein mit vBulletin 3.5 eingeführtes Konzept zur einfachen Erweiterung der Funktionalität von vBulletin.
Produkte vereinen Objekte die viele vBulletin Modifikationen nutzen
Achtung: Mit vBulletin 3.6.6 wurde die Bezeichnung Produkte durch Add-ons ersetzt. Dieses sowie etliche weitere Tutorials und Installationsanleitungen verwenden die ältere Bezeichnung Produkt.
Bitte beachten Sie dies bei der Bezeichnung von Menüpunkten, etc. (z.B. Add-ons & Plugins anstatt Produkte & Plugins)
Was sind die Vorteile von Produkten gegenüber Plugins
Plugins enthalten nur PHP Code. Besteht nun eine Modifikation aus mehreren Plugins, so müsste man z.B. bei Problemen jedes einzeln deaktivieren.
Produkte hingegen sind eine Einheit - wenn man ein Produkt deaktiviert so werden alle Plugins dieses Produkts deaktiviert.
Auch können Produkte viele weitere Bestandteile enthalten.
Was enhtält ein Produkt?
Ein Produkt besteht zunächst einmal nur aus einer ID , einer Bezeichnung und einer Versionsnummer - alle weiteren Bestandteile sind optional.
Man kann zustzälich noch eine Beschreibung eingeben, ab vBulletin 3.6 auch URLs für das Produkt (Support & Versions-Check).
Folgende Objekte können mit Produkten verknüpft werden;
Plugins (siehe eigene Anleitung)
Templates
Phrasen
Einstellungen
In vBulletin 3.6 darüber hinaus
Administrator-Hilfe
Frontend-Hilfe (FAQ)
Cronjobs
Verfügt ein Produkt noch über weitere Eigenschaften?
Ein Produkt kann auch über Installations-/Deinstallationscodes verfügen die beim Import bzw. Deinstallieren eines Produkts ausgeführt werden. Hiermit kann man z.B. nötige Tabellen erstellen/löschen oder Datenbankänderungen durchführen.
Somit erspart man sich in vielen Fällen eigene Installationsprogramme.
Achtung: Eine Benutzer-Interatkion ist hierbei nicht möglich!
Wenn dies nötig ist muss man weiterhin auf eigene Installationsprogramme zurückgreifen
vBulletin 3.6 bietet darübere hinaus die Möglichkeit Abähngigkeiten, z.B. von einer bestimmten mySQL-Version oder anderen Produkten zu definieren.
Diese werden bann bei Installation, Deinstallation, etc. automatisch geprüft und die Aktion ggf. abgewiesen wenn die Bedingungen nicht erfüllt sind.
Wie erstelle ich ein Produkt?
Wer selbst Produkte erstellen möchte muss sein Board im Debug-Modus betreiben.
Hierzu gibt es die eine Einstellung in der Datei config.php im Verzeichnis includes:
PHP:
----------
Der Inhalt dieses Abschnitts ist nur für Lizenznehmer sichtbar, Sie werden derzeit jedoch nicht als Lizenzinhaber erkannt.<br />
<br />
Bitte öffnen Sie den <a href="http://members.vbulletin-germany.com/membersupport_priority.php">Kundenbereich</a>, tragen Sie Ihre E-Mail-Adresse ein, mit der Sie sich hier registriert haben und aktivieren Sie die Lizenzüberprüfung für http://www.vbulletin-germany.org.
----------
Dies aktiviert den Debug-Modus lediglich im Administrator-Kontrollzentrum, was im Regelfall ausreichend ist.
Bevor man einem Produkt weitere Bestandteile hinzufügen kann muss man dieses erstellen:
ACP / Plugins & Produkte / Produkte verwalten
Hier klickt man unten den Link Produkt importieren/hinzufügen und fügt auf der folgenden Seite ein Produkt hinzu.
Produkt-ID
Dies ist ein beliebiger, bis zu 25 Zeichen langer Bezeichner (keine Sonderzeichen, der Präfix vb ist für die Verwendung durch Jelsoft reserviert) für das Produkt.
Jeder Bezeichner darf nur 1x vergeben werden!
Titel
Hier wird die Bezeichnung das zu erstellenden Produkts eingegeben
Version
Hier muss die Versionsnummer des Produkts eingegeben werden.
Dies muss folgendem Schema entsprechen:
a[.b.c.d] [Alpha|Beta|Gamma|RC|Release Candiate z]
Also z.B. 3.4.0.1 Beta 7 oder 1.0.4 oder 3.5 RC 2
URL zum Produkt (nur vBulletin 3.6)
Hier kann eine Infor-Seite zum Produkt angegeben werden
URL zum Überprüfen der Version
Hiere kann eine URL angegeben werden die jeweils die aktuelle Versionsnummer des Produkts zurückliefert
Zur Erstellung der einzelnen Bestandteile:
Plugins
Siehe eigene Anleitung
Phrasen
Hierzu erstellt man in der entsprechenden Phrasengruppe eine neue Phrase in der MASTER Sprache und wählt dabei das entsprechende Produkt aus.
Es können auch eigene Phrasengruppen verwendet werden; deren Erstellung behandelt eine eigene Anleitung
Templates
Hierzu erstellt man die entsprechenden Templates im MASTER Style und wählt das entsprechende Produkt aus
Admin-Hilfe, Frontend-Hilfe, Einstellungen & Cronjobs (nur vBulletin 3.6)
Hierbei ist es wichtig vBulletin Standard = Ja zu setzen
Was ist mit Template-Änderungen?
Es gibt derzeit keine Möglichkeit um Template-Änderungen über Produkte zu realisieren.
Hierzu verfasst man am besten eine Anleitung (Suche ..., Ersetze ...) mit Hilfe derer der Nutzer seine Templates entsprechend ändern kann.
Man kann mit Hilfe von Template-Conditionals überprüfen ob ein bestimmtes Produkt aktiv ist und so dessen GUI nur dann anzeigen wenn es aktiv ist:
CODE:
----------
Der Inhalt dieses Abschnitts ist nur für Lizenznehmer sichtbar, Sie werden derzeit jedoch nicht als Lizenzinhaber erkannt.<br />
<br />
Bitte öffnen Sie den <a href="http://members.vbulletin-germany.com/membersupport_priority.php">Kundenbereich</a>, tragen Sie Ihre E-Mail-Adresse ein, mit der Sie sich hier registriert haben und aktivieren Sie die Lizenzüberprüfung für http://www.vbulletin-germany.org.
----------
Mein Produkt benötigt eigene Tabellen oder muss vorhandene ändern, wie gehe ich vor?
Produkte können über Installations-/Deinstallations-Code verfügen.
Für jede Version eiens Produkts kann dabei ein eigener Satz Codes erstellen werden.
Das Plugin-System wird dann die nötigen Codes bei Installation bzw. Deinstallation ausführen.
Um einen Installations-Deinstallationscode hinzuzufügen ruft man Produkte & Plugins, Produkte verwalten auf.
In diesem Fenster wählt man im Dropdown des jeweiligen Produkts den Punkt Bearbeiten.
In dem daraufhin erscheinenden Dialogfenster kann man untern bei Neuen Installations/Deinstallations-Code hinzufügen einen entsprechenden Code eingeben.
Beispiel für die Erstellung einer neuen Tabelle:
PHP:
----------
Der Inhalt dieses Abschnitts ist nur für Lizenznehmer sichtbar, Sie werden derzeit jedoch nicht als Lizenzinhaber erkannt.<br />
<br />
Bitte öffnen Sie den <a href="http://members.vbulletin-germany.com/membersupport_priority.php">Kundenbereich</a>, tragen Sie Ihre E-Mail-Adresse ein, mit der Sie sich hier registriert haben und aktivieren Sie die Lizenzüberprüfung für http://www.vbulletin-germany.org.
----------
Beispiel für das ändern der User-Tabelle:
PHP:
----------
Der Inhalt dieses Abschnitts ist nur für Lizenznehmer sichtbar, Sie werden derzeit jedoch nicht als Lizenzinhaber erkannt.<br />
<br />
Bitte öffnen Sie den <a href="http://members.vbulletin-germany.com/membersupport_priority.php">Kundenbereich</a>, tragen Sie Ihre E-Mail-Adresse ein, mit der Sie sich hier registriert haben und aktivieren Sie die Lizenzüberprüfung für http://www.vbulletin-germany.org.
----------
Der letzte Parameter beschreibt ob ein bereits vorhandenes Feld gleichen Names überschrieben werden soll (true) oder nicht (false).
Für weitergehende Funktionen, sieh Datei class_dbalter.php im Verzeichnis includes
Mein Produkt benötigt bestimmte Versionen von mySQL, PHP, vBulletin oder eines anderen Produkts. Wie stelle ich dies sicher?
vBulletin bietet ab Version 3.6 die Möglichkeit entsprechende Abhängigkeiten zu definieren welche dann automatisch geprüft und ggf. Aktionen abgelehnt werden.
Um eine solche Abhängigkeit zu definieren ruft wie oben Produkt bearbeiten auf und gibt dort die entsprechenden abhängigkeiten ein.
Wie gebe ich ein von mir erstelles Produkt weiter?
Hierzu wählt man Unter Produkte & Plugins, Produkte verwalten im Dropdown des jeweiligen Produkts den Punkt Exportieren
Dabei wird eine XML-Datei mit der Definition des Produks und aller seiner Bestandteile (Plugins, etc.) erstellt.
Wie installiere ich ein Produkt?
Auch wieder über Produkte & Plugins, Produkte verwalten indem man unten den Link Produkt importieren/hinzufügen anklickt.
Im darauffolgenden Formular wählt man die XML-Datei aus.
Beim Update eines Produkts ist hierbei zu beachten dass man das Kontrollkästchen Überschreiben erlauben aktiviert.