Entpacken Sie zunächst das Archiv welches Sie von yagendoo.com heruntergeladen haben. Dieses beinhaltet einen Ordner mit zwei zip-Dateien: Die Komponente Virtuemart Merchant Connect und das Google Merchant Center Plugin.

Wählen Sie im Joomla! Admin-Panel den Menüpunkt "Erweiterungen > Installieren/Deinstallieren".

Klicken Sie auf "Datei auswählen" und wählen Sie die Datei "yagendoo_vmmerchant_2.0.zip" aus dem eben entpackten Ordner. Bestägen Sie die Installation mit einem Klick auf "Hochladen und Installieren".
Wenn die Installation erfolgreich war sehen Sie eine entsprechende Benachrichtigung.

Hinweis: Sollte eine Fehlermeldung angezeigt werden vergewissern Sie sich, dass die Schreibrechte für alle Dateien und Ordner in Ihrem Joomla! Verzeichnis korrekt gesetzt sind.

Sie finden die Komponent Yagendoo Virtuemart Merchant Connect in dem Menü "Komponenten".

Wenn Sie die Komponente auswählen landen Sie zunächst im "Dashboard". Dieses bietet ihnen eine kleine Statistik über die für ihre Feeds verfügbaren Produkte (orange) sowie eine Im- und Exportfunktion (grün).

Ausserdem haben Sie eine horizontale Navigationsleite mit einigen Reitern (rot). Hier unter "Produkte" können Sie beispielsweise ihre Produkte für die Benutzung in Feeds vorbereiten. Eine Übersicht über diese Feeds finden Sie wenn Sie den Reiter "Feeds" wählen. Für jenden dieser Feeds benötigen Sie ein Plugin. Diese Plugins können im "Apps-Reiter" (Schraubenschlüssel) eingesehen und verwaltet werden.

Auf die einzelnen Tabs wird im Verlauf dieser Dokumentation genauer eingegangen.

Damit Sie das Yagendoo Merchant Connect Modul produktiv nutzen können, müssen Sie mindestens ein Merchant Plugin installieren.

Das Google Merchant Plugin wird bereits mitgeliefert und und laufe dieser Dokumentation als Beispiel dienen.

Das Plugin wird auf die gleiche Weise installiert wie die Komponente. Gehen Sie also nocheinmal zu Schritt 1 dieser Dokumentation und wählen sie satt der Komponente das Google Plugin, also die Datei plg_vmmerchant_google_merchant_2.0.0.zip.

Nach der Installation welchseln Sie wieder zur Komponente "Yagendoo Virtuemart Merchant Connect" und wählen den Reiter "Apps" (Schraubenschlüssel). Hier sollte das eben installierte Plugin nun erscheinen.

Um das Plugin verwenden zu können müssen Sie es nun noch veröffenltichen. Klicken Sie dazu einfach auf das rote Icon in der Spalte "Veröffentlich". Wenn alles klappt ist das Icon nun grün.

Damit ihre Produkte in die Feeds aufgenommen werden können werden noch einige zusätzliche Informatione benötigt. Etwa eine MPN und GTIN Nummer.

Um diese Nummer zu ergänzen wechseln Sie zunächst in den Reiter Produkte (rot). Hier können Sie nun die Nummern in die entsprechenden Felder (orange) eintragen. Um die Werte zu speichern kicken Sie auf die kleine Diskette (grün) ganz rechts- Nach dem Speichern sollten Sie in der entsprechenden Spalte eine kleines grünes Icon sehen.

Weiterhin haben Sie die möglichkeit einen alternativen Produkt-Title anzugeben. Wenn Sie den Titel im entsprechenden Feld ändern wird dieser neue Titel in den Feeds verwendet und nicht reguläre Titel welchen Sie im Virtuemart festgelegt haben.
Hinweis: Der Alternative Titel wird nun in den Feeds verwendet. Ihre Virtuemart-Produktseiten bleiben selbstverständlich unverändert!

Hinweis: Das folgende Feature ist nur in der Merchant Connect Version für Joomla 2.5 und VM2 verfügbar.
In einigen Ländern bzw. für einige Produkte ist es notwendig eine Google-Produkt-Kategorie zum Feed hinzuzufügen. Um das zu erreichen welchseln Sie zunächst in das "Kategorien"-Tab. Hier finden Sie eine Übersicht aller Virtuemart-Kategorien. Sie können jeder dieser Kategorien eine Google-Kategorie zuweisen indem Sie diese in das entsprechende Feld neben der Virtuemart-Kategorie (rot markiert) eintragen. Anschließen speichern Sie diese Kategorie mit einem Klick auf das Disketten-Symbol.
Im Feed wird dann allen Produkten die sich in einer Virtuemart-Kategorie befinden die entsprechende Google-Kategorie zugeweisen.
Bitte achten Sie darauf nur gültige Google-Kategorien einzutragen. Sollten Sie nicht wissen welche Kategorien das sind, benutzen Sie die Link rechts neben der Suchbox (grün markiert).

Nachdem Sie ein Feed Plugin installiert haben und ihre Produkte entsprechend vorbereitet haben können Sie nun einen Feed anlegen. Welcheln Sie hierzu zunächst in den Reiter "Feeds" (rot). Hier werden alle von ihnen angelegten Feeds aufgelistet.

Um einen neuen Feed hinzuzufügen klicken Sie oben rechts auf das orangene "Neu" Symbol (orange). Es erscheint ein Formular in dem Sie einige Einstellungen für ihren Feed festlegen können.

Tragen Sie einen Namen und eine Beschreibung für ihren Feed ein (orange) und wählen Sie die Kategorien der Produkte die ihn diesem Feed aufgelistet werden sollen. Schließlich wählen Sie bei "Freigeben" noch "Ja" aus. Um die Einstellungen zu speichern klicken Sie oben rechts auf das Symbol "Speichern" (rot).

Sie sollten nun ihren gerade angelegeten Feed in der Tabelle sehen können.

Nachdem Sie einen neuen Feed angelegt haben sehen Sie in der Tabelle auch einen Link zu der entsprechenden Feed URL. Klicken Sie z.B. für den Google Merchant Feed einfach auf den Link "Feed URL" (rot) in der Spalte "Google Merchant". Nun sehen Sie die URL zum Feed in der Adresszeile ihres Browsers. Diese URL können Sie nun bei Google oder einem entsprechenden anderen Anbieter verwenden.

Um die Feeds bestmöglich an ihre Ansprüche anzupassen bieten die Merchant Plugins verschiedene Optionen. Um diese zu verändern wählen Sie zunächst den Reiter "Apps" (Schraubenschlüssel) [rot] und klicken Sie auf den Titel des Plugins (orange).

Für eine Dokumetation der einzelnen Optionen schauen Sie bitte in die Dokumentation der einzelnen Plugins.

Unter Umständen ist es sinnvoll Daten aus der Erweiterung zu exportieren und später wieder zu importieren. Beispielsweise dann wenn Sie große Datenmenge zunächst in einer CSV-Datei bearbieten möchten.

Um Daten zu exportieren bzw. zu importieren welches Sie zunächst in das Tab "Dashboard". Mit einem Klick auf "Produkt Daten exportieren" (rot markiert) erhalten Sie eine CSV-Datei welche alle Information aus dem Produkte-Tab enthält.
Wenn Sie auf "Feed Daten exportieren" (grün markiert) erhalten Sie ein CSV-Datein mit all Ihren konfigurierten Feeds.
Nachdem Sie diese Dateien heruntergeladen haben könnsen Sie sie mit einem beliebigen Text-Editor (oder jedem anderen Programm das mit CSV-Daten umgehen kann) bearbeiten.
Um die Daten später wieder zu importieren wählen Sie zunächst die CSV-Datei aus welche Sie importieren mächten indem Sie auf den "Datei auswählen" Button klicken (orange markiert). Aschnließend müssen Sie noch auswählen ob es sich um eine CSV-Datei mit Produkten oder Feeds handelt. Benutzen Sie dazu die entsprechenden Radio-Buttons (blau markiert).
Um den Import zu starten klicken Sie nun noch auf den "Senden" Button.

In den Optionen des Google Merchant Center Plugins haben Sie eine Reihe von Optionen (orange) die hier der Reihe nach erklärt werden.

Zunächst können Sie das Land wählen für den ihr Feed bzw. ihr Shop bestimmt ist. Danach können Sie einen Beschreibungstext für ihren Shop auswählen. Weiterhin können Sie eine Kundengruppe wählen die im Feed berücksichtigt werden soll. Im Normalfall bleibt dieser Wert auf default.

Google verlangt, dass Sie den Zustand der Produkte angeben, dafür können Sie das nächste Dropdown-Feld nutzen. Darunter können Sie auswählen ob Kindprodukte in ihrem Feed erscheinen sollen.

Mit den nun folgenden Ja/Nein Feldern können Sie verschiedene Felder für den Feed an oder ausschalten.

Als nächstes folgt eine Reihe von Felder, die zwar im Feed angegeben werden können aber nicht immer einheitlich in Virtuemart vorhanden sind. Um dieses Problem zu lösen können Sie für jedes dieser Felder (z.B. Farbe, Größe, Genre, ...) das entsprechende Feld aus ihrem Virtuemart wählen.

Mir den nächsten 2 Drow Downs können Sie festlegen ob Kundenbewertungen mit in den Feed aufgenommen werden sollen.
Mit dem lezten Feld können Sie genau festlegen wo im Google Merchant Center ihre Produkte erscheinen sollen.