Systemvoraussetzungen

Joomla! Version

Alle Produkte von Yagendoo sind ausschließlich für Joomla! 1.5 oder spätere Versionen entwickelt!

PHP Version

Mindestens PHP5 erforderlich! Die PHP Version 5 oder darüber ist die primäre Entwicklungsplattform für alle Yagendoo-Erweiterungen. Sollten Sie noch PHP4 nutzen, ist dies kein Problem; in der Regel können Sie bei Ihrem Webhoster problemlos die PHP Version auf PHP5 updaten.

Virtuemart Version

Virtuemart 1.1.3 oder eine höhere Version der 1.1.x Serie vorausgesetzt! Die Virtuemart Version 1.1.3 oder darüber ist die primäre Entwicklungsplattform für alle Yagendoo-Erweiterungen.

Die Installation der Yagendoo VM Such Komponente ist sehr einfach und erfordert nur wenige Schritte. Im Folgenden erfahren Sie, wie Sie die Yagendoo Virtuemart Suchkomponente nach dem Download installieren und in Betrieb
nehmen.

1. Installation der Yagendoo VM Meta Komponente

a.) Entpacken Sie das Paket (yagendoo_vmmeta.zip), das Sie über Ihren Downloadlink nach dem Kauf geladen haben, lokal auf Ihrem PC. Sie finden darin das Komponenten-Paket und einige Dateien mit Informationen.

b.) Navigieren Sie in Ihr Joomla! Backend zum Joomla! Installer und wählen Sie das Komponenten-Paket, das Sie zuvor geladen haben und das nun auf Ihrem PC liegt, aus und installieren Sie dies über den Joomla! Installer. Bei erfolgreicher Installation erhalten Sie die Meldung, dass das Modul erfolgreich installiert wurde.

Hinweis: Da manche Server nicht 100% Joomla!-tauglich sind, kontrollieren Sie bitte die CHMOD-Rechte der Dateien und Ordner. Alle Ordner müssen einen CHMOD von 755 und alle Dateien einen CHMOD von 644 haben.

2. Übersicht der Yagendoo VM Meta Komponente

Navigieren Sie nun in Ihrem Joomla! Backend zum Menüpunkt "Komponenten" und öffnen Sie den Punkt "yag VM Meta". Auf der linken Seite befindet sich das Hauptmenu. Innerhalb des Menus können Sie über die Tabs oberhalb des Inhaltsfensters navigieren.

a) Start: Auf der Startseite finden Sie eine Übersicht über die bisher von Ihnen eingegebenen Metadaten, wie z.B. die Anzeige fehlender, doppelter, zu kurzer oder zu langer Metafelder der Produkte und der Kategorien

b) Kategorien: Hier können Sie alle Metadaten der Kategorien eingeben. Dabei steht Ihnen eine Hilfe zur Seite, die anzeigt, ob die Länge der Metafelder optimal ist. Außerdem haben Sie verschiedene Filtermöglichkeiten.

c) Produkte: Hier geben Sie die Metadaten der Produkte Ihres Virtuemart Shops ein. Auch hier finden Sie die Hilfe zur Längenoptimierung und Filterung der Daten.

d) Import: Den Import der Metadaten aus Virtuemart, anderen Komponenten oder aus CSV- bzw. XML-Dateien finden Sie hier. Auch der Export Ihrer Virtuemart-Produkte oder -Kategorien in CSV oder XML ist hier zu finden.

e) Konfiguration: Hier können Sie die Shopmetadaten eingeben sowie den Export und Import konfigurieren.

f) Credits: Hier finden Sie weitere Informationen und Links, die Ihnen bei der Bedienung helfen. Außerdem steht der Changelog hier zur Verfügung.

3. Die Startseite

Auf der linken Seite sehen Sie die Übersicht über die Metadaten Ihrer Virtuemart-Produkte. Auf der rechten Seite entsprechend die Daten für die Kategorien. Einen möglichen Auszug finden Sie in dem Screenshot unter diesem Punkt.

3. Eingabe der Meta-Daten über die Komponente

Navigieren Sie nun erneut in Ihrem Backend zum Menüpunkt "Komponenten" und öffnen Sie erneut den Punkt "yag VM Meta-Manager". Sie haben die Auswahl zwischen der Ansicht zur Eingabe der Meta-Daten für die Virtuemart-Kategorien und die der Produkte. Die Eingabe erfolgt in beiden Ansichten genau gleich. Öffnen Sie eine der beiden Ansichten. Folgende Möglichkeiten haben Sie:

Meta Titel: Tragen Sie hier den Meta-Titel ein, der für Suchmaschinen relevant ist. Das kleine Icon neben der Eingabe zeigt Ihnen an, wenn die Länge des Titels die perfekte Länge erreicht hat; der Titel sollte eine Länge von ca. 40-65 Zeichen haben. Wenn diese erreicht sind, ändert sich das Icon zu einem Stern. Sollten es zu viele Zeichen sein, zeigt das Feld Ihnen ein Icon mit einem Pfeil nach unten an. Zum Speichern klicken Sie das jeweilige Disketten-Icon.

Meta Keywords: Tragen Sie hier die Meta-Keywords ein, die für Suchmaschinen relevant sind. Das kleine Icon neben der Eingabe zeigt Ihnen an, wenn die Länge der gesamten Keywords die perfekte Länge erreicht hat; die Keywords sollten eine Länge von ca. 170-200 Zeichen haben. Wenn diese erreicht sind, ändert sich das Icon zu einem Stern. Sollten es zu viele Zeichen sein, zeigt das Feld Ihnen ein Icon mit einem Pfeil nach unten an. Zum Speichern klicken Sie das jeweilige Disketten-Icon.

Meta Beschreibung: Tragen Sie hier die Meta-Beschreibung ein, die für Suchmaschinen relevant ist. Das kleine Icon neben der Eingabe zeigt Ihnen an, wenn die Länge der Beschreibung die perfekte Länge erreicht hat; die Beschreibung sollte eine Länge von ca. 140-150 Zeichen haben. Wenn diese erreicht sind, ändert sich das Icon zu einem Stern. Sollten es zu viele Zeichen sein, zeigt das Feld Ihnen ein Icon mit einem Pfeil nach unten an. Zum Speichern klicken Sie das jeweilige Disketten-Icon.

4. Import / Export der Meta-Daten

Virtuemart: Im ersten Tab befindet sich der Import aus Virtuemart. Im obersten Absatz geht es um den Import von Meta-Titeln. Sie können allen Titeln, die Sie aus Virtuemart als Meta-Titel importieren, einen Präfix und Suffix hinzufügen. Das Präfix bietet sich z.B. an, wenn Sie vor jeden Artikel oder jede Kategorie den Namen Ihres Shops setzen wollen. Außerdem können Sie durch Setzen des Hakens in "Titel importieren" bestimmen, ob der Titel importiert werden soll.

Danach geht es um die Meta-Keywords. Da es im Virtuemart nichts Vergleichbares gibt, können Sie hier auswählen, ob Sie ein bestimmmtes Feld als Keywords verwenden möchten. Zur Auswahl steht der Titel, die Kurz- und die Langbeschreibung oder Sie wählen aus, dass die Keywords aus keinem dieser Felder importiert werden sollen. Darüber können Sie bestimmen, welche Keywörter immer vorkommen sollen und darunter, ob die Keywörter überhaupt importiert werden sollen.

Tipp: Sollten Sie die Keywords aus keinem der Virtuemartfelder übernehmen wollen, aber wissen, dass bestimmte Keywords in jeder Kategorie oder jedem Produkt vorkommen sollen, wählen Sie in dem Dropdown "Keins" aus, geben Sie die gewünschten Keywords bei den immer vorkommenden Keywords ein und setzen Sie den Haken auf "Keywords importieren".

Beim Import der Metabeschreibung wird bei den Kategorien immer die Beschreibung genutzt; bei den Produkten haben Sie die Wahl zwischen der Kurz- und Langbeschreibung. Auch hier können Sie wählen, ob die Meta-Beschreibung importiert werden soll.

Mit dem nächsten Haken geben Sie an, ob bereits existierende Metadaten überschrieben werden sollen. Als letzte Auswahl steht Ihnen die Wahl zwischen Produktimport und Kategorieimport zur Verfügung.

Komponenten: In Ihrer Downloadarea auf yagendoo.com finden Sie außer der Komponente auch zwei Plug-Ins für den Import der Daten aus den bekannten Joomla! Komponenten sh404Sef (Version 1.x) und JoomSef (3.x). Installieren Sie das für Sie passende Plug-In wie gewohnt über das Joomla! Backend und navigieren Sie dann zurück zur Metamanager Komponente. Im zweiten Tab finden Sie den Import aus diesen Plug-Ins.

Wenn das Plug-In installiert UND aktiviert wurde, sehen Sie hier eine Schätzung der möglichen Importe aus diesen Komponenten. Beim Drücken des Importieren-Buttons werden diese Daten importiert, bereits vorhandene Metadaten werden überschrieben. Sollten Sie den Import aus einer anderen Komponente benötigen, wenden Sie sich bitte an unseren Support.

Dateien: Über den dritten Tab können Sie die Metadaten aus CSV- oder XML-Dateien importieren. Laden Sie eine entsprechende Datei auf den Server. Diese wird Ihnen dann mit dem entsprechenden Symbol angezeigt, wie Sie als Beispiel auf der rechten Seite sehen können.

Tipp: Erstellen Sie zuerst über den Export eine Datei mit Metadaten, die Sie bereits eingegeben haben. Auf diese Weise vermeiden Sie Fehler beim Import.

Sollten Sie den Import oder Export in ein anderes Format benötigen, wenden Sie sich bitte an unseren Support.

Export: Zuletzt haben Sie noch die Möglichkeit, die eingegebenen Metadaten Ihres Virtuemart Shops zu exportieren. Dabei können Sie den Namen der neuen Datei angeben, das Format wählen und festlegen, ob die Produkte oder Kategorien Ihrer Virtuemart Komponente exportiert werden sollen.

Die Einstellungen zum Export aus und Import in Dateien können Sie in der Konfiguration vornehmen.

5. Konfiguration

Shop: Im ersten Tab der Konfiguration können Sie die Metadaten Ihres Shops angeben. Diese werden immer dann gesetzt, wenn der Nutzer auf Seiten wie z.B. dem Warenkorb, der Shop-Startseite oder der Profilseite ist.

CSV Konfiguration: Der Werttrenner gibt die Trennwerte der Werte an; meistens wird hierfür ein Semikolon verwendet. Es folgt das wertumschließende Zeichen der Werte. Oft wird dieses Zeichen genutzt: ". Es wird empfohlen, dieses Feld auszufüllen, um Fehlern vorzubeugen. (Beispielsweise kann ein Fehler entstehen, wenn sich ein Semikolon in einer Artikelbeschreibung befindet und als Werttrenner genutzt wird)

Jetzt können Sie die Referenz aussuchen, die bei Produkten genutzt werden soll. Dazu können Sie zwischen SKU (Artikelnummer) oder ID wählen. Bei Kategorien wird immer die ID genutzt. Es folgen die Beschreibungen der Spalten. Wenn die erste Spalte Ihrer CSV Datei keine beschreibende Spalte ist, geben Sie hier die Nummern der Spalten ein, in denen sich die jeweiligen Metadaten befinden.

XML Konfiguration: Das äußerste Element ist der Root Tag. Dessen Namen können Sie hier bestimmen. Danach das umschließende Element jedes einzelnen Elements. Es folgen die Namen der Elemente für die ID, die SKU, den Titel, die Keywords und Beschreibung.

6. Eingabe der Meta-Daten über Virtuemart

Die Eingabe der Meta-Daten in Virtuemart selbst erfolgt in der jeweiligen Kategorie oder in dem Produkt. Durch das Installieren des VM Meta-Managers werden die Felder zur Eingabe der Meta-Daten automatisch in Virtuemart erstellt und angezeigt. Die Eingabe erfolgt genau wie in der Komponente. Lesen Sie dazu mehr in Punkt 3.

6. Nutzung mit Joomfish

Zur Unterstützung von mehrsprachigen Seiten ermöglicht es der VM Meta-Manager, alle eingetragenen Daten per Joomfish zu übersetzen. Wenn Joomfish bei der Installation des VM Meta-Managers bereits installiert ist, wird das Joomfish Content-Element automatisch in den richtigen Ordner kopiert. Sollten Sie Joomfish zu einem späteren Zeitpunkt installieren, müssen Sie das Content-Element der Komponente per Hand in den Order kopieren. Die Übersetzung der Daten erfolgt wie bei allen anderen Komponenten per Auswahl des Elementes und Eingabe der Daten im Joomfish-Backend.