It’s Tutorial Time. Diesmal zeige ich dir, wie du die Ecommerce Anwendung Spree unter Ubuntu 18.04 installierst. Spree hebt sich von den anderen bekannten E-Commerce Lösungen wie Magento, PrestaShop oder OpenCart deutlich ab. Basierend auf Ruby eignet sich Spree für jede Art von Ecommerce-Anwendung: ein Online-Shop, ein Multi-Vendor-Marktplatz, ein reichhaltiges, inhaltsorientiertes Commerce-Projekt, eine Social-Commerce-Website oder eine Backend-Engine für eine E-Commerce-Mobil- oder Tablet-App (iOS, Android). Spree ermöglicht es zudem sein einzigartiges, schönes Frontend UX zu entwickeln. Im Backend kombiniert es API-gesteuerten Omni-Channel-Support mit mehreren Lagerstandorten und ermöglicht so Skalierbarkeit und Flexibilität.

Spree ermöglicht durch den Aufbau eine schnelle Entwicklungs- und kurze Markteinführungszeit. Die schlank gehaltene Kernfunktionalität kann leicht mit einer Sammlung von zahlreichen offiziellen und Hunderten von inoffiziellen Erweiterungen angepasst werden. Auch Integrationen in Systeme von Drittanbietern lassen sich problemlos realisieren.
Aber vor allem ist Spree Commerce eine lebendige Gemeinschaft von Anwendern, Entwicklern, Mitwirkenden, Agenturen und Softwarehäusern, die es für ihre E-Commerce-Projekte nutzen. Die meisten davon befinden sich in den offiziellen Spree-Slack-Kanälen.

Am Ende dieses Tutorials hast du dein eigenes lauffähiges Spree Projekt, welches du dann nach deinen eigenen Wünschen erweitern und ausbauen kannst.

Vorbereitungen

Verbinde dich zunächst via SSH auf deinen eigenen VPS oder solltest du keinen haben, erstelle dir einfach und unkompliziert einen neuen VPS bei Tech4Hosting. Desweiteren musst du sicherstellen, dass Ruby und RubyGems auf deinem System installiert sind.

Nachdem die Grundvoraussetzungen gegeben sind, muss nun noch Rails, Bundler und ImageMagick installiert werden.

Rails installieren

Spree benötigt die neueste Rails Version 5.2.0 um zu laufen.
In den meisten Fällen lässt sich Rails am besten über RubyGems installieren.

gem install rails -v 5.2.0

Bundler installieren

Bundler ist das gängige Standard-Tool um Ruby Abhängigkeiten zu verwalten. Um mit Spree zu arbeiten, solltest du wissen wie Bundler zusammen mit Rails funktioniert.

ImageMagick installieren

Als nächstes muss das Tool ImageMagick installiert werden. Spree nutzt das Tool um Bilder zu manipulieren. Die Library macht ein automatisches Resizing von Produktbildern und die Erzeugung von Produkt Thumbnails möglich. Die Installation ist nicht Teil dieses Tutorials, über Google lassen sich viele gute Anleitungen zur Installation unter Ubuntu finden.

Neues Spree Projekt erstellen

Die Steuerung von Spree durch RubyGem erlaubt es dir Spree als neues Rails Projekt zu starten oder Spree in ein existierendes Projekt zu integrieren. In den folgenden Schritten zeige ich dir, wie du eine neue Rails Applikation und damit einen brandneuen Spree Shop erstellst.

Rails Application erstellen

Starte mit der Erzeugung einer Standard Rails Applikation:

rails _5.2.0_ new mystore

Spree zur neuen Rails Applikation hinzufügen

Nun kann Spree zu der Basis Rails Applikation hinzugefügt werden. Genauso würdest du vorgehen, wenn du Spree zu einer bestehenden Rails Applikation hinzufügen würdest (angenommen diese nutzt die korrekte Rails Version).

Wechsel nun in das neue Verzeichnis:

cd mystore

Füge Spree anschließend zu deinem Gemfile hinzu:

gem 'spree', '~> 3.6'
gem 'spree_auth_devise', '~> 3.3'
gem 'spree_gateway', '~> 3.3'

Und führe

bundle install

aus.

Dann benutzt du die install generators um Spree einzurichten:

rails g spree:install --user_class=Spree::User
rails g spree:auth:install
rails g spree_gateway:install

Hello, Spree

Schon nach dem Ausführen von diesen wenigen Befehlen, hast du eine funktionelle Spree Anwendung auf deinem VPS. Um die Anwendung über deinen Browser aufrufen zu können, brauchst du nur noch den Webserver zu starten:

rails server

Dieser Befehl startet eine Instanz vom default Webrick Webserver (Spree kann darüber hinaus mit vielen weiteren Webserver betrieben werden). Du kannst deinen neue Spree Anwendung nun über die IP Adresse deines Servers und Port 3000 aufrufen.

http://[IP]:3000

Mit „ctrl + C“ in deinem Terminal kannst du den Webserver wieder beenden. Im Development Modus kannst du Änderungen am Shop durchführen ohne den Server zu stoppen. Die Änderungen an deinen Dateien werden automatisch vom Server erkannt.

In das Spree Backend einloggen

Als nächstes kannst du dich im Admin Interface umschauen. Lege hierzu zunächst mit rake einen neuen Admin User in der Datenbank an:

rake spree_auth:admin:create

Anschließend navigierst du mit dem Browser zu

http://[deine-IP]/admin

und loggst dich ein.

Fazit

So schnell hast du deine eigene fortschrittliche und skalierbare Ecommerce Plattform bei Tech4Hosting installiert. In der Developer Dokumentation von Spree warten weitere gute Tutorials auf dich. Als nächstes kannst du dort erkunden, wie du deine Spree Anwendung mit Extensions erweiterst.

Zurück zur Tutorial Übersicht Back to Tutorial Overview