Shariff für Contao

[DetlefT]

Hallo zusammen,

ich bin heute bei der Suche nach einer Shariff-Lösung mit XING- und LinkedIn-Buttons bei Github auf die Lösung von hofff.com gestoßen. Leider findet sich die Erweiterung nicht im ER, so dass ich versuchen musste, sie händisch zu installieren. Und kaum zu glauben, ich habe es geschafft. Funktioniert prima und hat auch noch einen Pinterest-Button mit an Bord, den ich allerdings z.Zt. noch nicht brauche.

Für die blutigen Contao-Greenhorns wie mich hier eine Kurzanleitung zur Installation:

• Paket von https://github.com/hofff/contao-shariff downloaden, auf der Festplatte entpacken.
• Den innersten Ordner namens [contao-shariff-1.x] umbenennen nach [hofff_shariff]
• Den darin enthaltenen Ordner [contao-module] auflösen, so dass die Ordnerstruktur nun folgendermaßen aussieht:
  [hofff_shariff]
  
  Ordner [assets]
  Ordner [config]
  Ordner [dca]
  Ordner [languages]
  Ordner [src]
  Ordner [templates]
  Datei (.gitignore)
  Datei (composer.json)
  Datei (README.md)
• Ordner [hofff_shariff] mit komplettem Inhalt nach [./system/modules/] kopieren.
• http://example.com/contao/install.php aufrufen.
• Datenbank ist nicht aktuell, aktualisieren.
• Ein Modul erstellen oder Inhaltselement (unter "Linkelemente") einfügen.
• Gewünschte social buttons wählen, optonal weitere Einstellungen.
• Bei Bedarf CSS anpassen. Ich habe an den Anfang von "/hofff_shariff/assets/css/shariff.min.css" die Deklaration ".shariff{width:50%;margin:40px auto 20px;}" gestellt, damit der Container nicht über die gesamte Breite geht und etwas Abstand nach oben und unten bekommt.

Ich habe es in der Testinstallation eingebaut, funktionierte sofort. In der Produktiv-Install war nix zu sehen. Erst nach einer gründlichen Bereinigung über die Systemwartung war alles okidoki.

Danke an die Hoffs - Klasse Erweiterung!

PS: Der Info-Button fehlt zwar, aber da sollte jeder bei Bedarf eine brauchbare Lösung finden, ist ja schließlich nur ein Link nach Heise.
---------------------------------------------
Edit 04.09.2015 - 11:06: Korrekturen aus Post #4 in blau eingearbeitet.

[Sluggish86]

Hallöchen,

ich hab soeben versucht diese Erweiterung zu installieren, kann deiner Anleitung allerdings nicht so ganz folgen.

Die Zipdatei die ich runtergeladen habe enthält folgende [Ordner]-/(Datei)struktur.

1. [contao-shariff-1.x]

1.1 [contao-module]

1.1.1 [assets]
1.1.2 [..]
1.1.3 [..]
1.1.4 [..]
1.1.5 [templates]

1.2 [src]
1.3 (.gitignore)
1.4 (composer.json)
1.5 (README.md)

Folgendes habe ich versucht:
1. Zip Datei extrahieren und Ordner 1.[contao-shariff-1.x] inklusive inhalt in system/modules kopieren.

Resultat: install.php benötigt keine Datenbankaktualisierung und Contao kennt kein Shariff.

2. Order 1.[contao-shariff-1.x] umbenennen in [hofff_shariff] und inklusive Inhalt in system/modules kopieren.

Resultat: install.php benötigt keine Datenbankaktualisierung und Contao kennt kein Shariff.

3. Ordner 1.1 [contao-module] umbenennen in [hofff_shariff] und inklusive Inhalt in system/modules kopieren.

Resultat: install.php führt Datenbankaktusalisierung durch -> Modul Shariff lässt sich im Backend anlegen und positionieren(im Layout oder im Artikel) -> im Frontend keine spur.

4. In Arbeit.

In der Autoload.php zu finden unter Ordner 1.1.2[config] steht folgendes:

TemplateLoader::addFiles(array
(
'hofff_shariff' => 'system/modules/hofff_shariff/templates',
'ce_hofff_shariff' => 'system/modules/hofff_shariff/templates',
'mod_hofff_shariff' => 'system/modules/hofff_shariff/templates',
));

was fürs umbenennen von 1.1 [contao-module] in [hofff_shariff] spricht.

Allerdings bin ich ziemlich ratlos welchen Ordner ich nun in system/modules einfügen muss.
Wäre schön wenn Du vielleicht nochmal erklären könntest wie Dein Workaround funktioniert.

Gruß,
Sluggish

edit: jquery ist aktiviert, die notwendige css ist eingebunden im header.

[folkfreund]

Dein Schritt 3 sieht doch eigentlich gut aus. Da stellt sich nicht mehr die Frage, was wohin kopiert werden muss. Die neue Frage lautet jetzt "warum erscheint nichts im FE?".
Hast du einen Link zu der Seite, damit man mal schauen kann?

folkfreund

[DetlefT]

1. [contao-shariff-1.x]

1.1 [contao-module]

1.1.1 [assets]
1.1.2 [..]
1.1.3 [..]
1.1.4 [..]
1.1.5 [templates]

1.2 [src]
1.3 (.gitignore)
1.4 (composer.json)
1.5 (README.md)

Hallo Sluggish86,

sorry, das habe ich dann leider falsch beschrieben. Richtig muss es sein:
[hofff_shariff]

1.1 [assets]
1.2 [config]
1.3 [dca]
1.4 [languages]
1.5 [templates]
1.6 [src]
(.gitignore)
(composer.json)
(README.md)

Wie geschrieben, hat sich in meiner 2. Installation zuerst auch nichts getan. Gründliche Bereinigung aller caches hat es dann gebracht. Sorry nochmal!
---------------------------------------------
Edit 04.09.2015 - 11:06: Korrektur in Post #1 eingefügt.

[Sluggish86]

Hallo DetlefT,

kein Problem, ich bin sehr dankbar, dass ich hier Hilfe bekomme

Nun bin ich soweit, dass ich das Modul wie von dir beschreiben eingefügt habe, sprich:

[hofff_shariff]

1.1 [assets]
1.2 [config]
1.3 [dca]
1.4 [languages]
1.5 [templates]
1.6 [src]
(.gitignore)
(composer.json)
(README.md)

Über die Systemwartung habe ich die kompletten Daten bereinigt. (Gibt es da weitere Möglichkeiten, "gründlicher" vorzugehen?)

Ruft man nun eine Seite auf die das Modul beinhaltet bekomme ich folgenden fehler in System-Log:

[2015-09-04 10:16] Module class "Hofff\Contao\Shariff\ModuleShariff" (module "hofff_shariff") …

Klick auf das Info Symbol liefert:

Details des Datensatzes ID 13 anzeigen
ID: 13
Datum: 2015-09-04 10:16
Ursprung: Frontend
Kategorie: ERROR
Benutzer:
Details: Module class "Hofff\Contao\Shariff\ModuleShariff" (module "hofff_shariff") does not exist
Funktion: Contao\Controller::getFrontendModule

Die Datei: ModuleShariff.php erreicht man wie folgt: 1.6 src -> 1.6.1 hofff -> 1.6.1.1 contao -> 1.6.1.1.1 shariff -> moduleshariff.php und sie enthält folgendes:

<?php

namespace Hofff\Contao\Shariff;

class ModuleShariff extends \Module {

public function __construct($element) {
parent::__construct($element);
}

public function generate() {
if(TL_MODE == 'BE') {
$tpl = new \BackendTemplate('be_wildcard');
$tpl->wildcard = '### Shariff ###';
$tpl->title = $this->headline;
$tpl->id = $this->id;
$tpl->link = $this->name;
$tpl->href = 'contao/main.php?do=themes&amp;table=tl_module&amp;act=edi t&amp;id=' . $this->id;
return $tpl->parse();
}

$this->shariff = Shariff::createFromDBRow($this->arrData);
$this->shariff->sendCountsIfBackendRequested();

$this->strTemplate = 'mod_hofff_shariff';

return parent::generate();
}

protected function compile() {
$this->Template->shariff = $this->shariff;
}
}

Mir stellt sich jetzt die Frage, liegt der Fehler immernoch an der falschen Ordnerstruktur(was ich bezweifle), liegt es am nicht "gründlich" genug aufgeräumten Backend oder an Fehler unbekannt?

Bin über jedwede Hilfe erfreut, denn nach wie vor ein absoluter Contao Einsteiger.

Danke und Gruß,
Sluggish

edit: Ich habe nun noch den Ordner 1.6 src aufgelöst, so dass 1.6.1 Hofff den platz von 1.6 einnimmt, dies brauchte auch nicht den ersehnten Erfolg.

[Sluggish86]

Dein Schritt 3 sieht doch eigentlich gut aus. Da stellt sich nicht mehr die Frage, was wohin kopiert werden muss. Die neue Frage lautet jetzt "warum erscheint nichts im FE?".
Hast du einen Link zu der Seite, damit man mal schauen kann?

folkfreund

Hallo folkfreund,
danke für die Unterstützung, die Seite existiert leider momentan nur lokal.
Wenn man sich den Quelltext im Browser anschaut, sieht man ebenfalls rein gar nichts von dem Modul, also nichtmal "leere" Container die auf die Existenz hindeuten.

Gruß,
Sluggish

[Sluggish86]

Heureka!

Endlich funktioniert es!

Ursache:

config/autoload.Ini Inhalt:

;;
; Configure what you want the autoload creator to register
;;
register_namespaces = true
register_classes = true
register_templates = true

;;
; Override the default configuration for certain sub directories
;;
[vendor/*]
register_namespaces = false
register_classes = false
register_templates = false

config/autoload.php Inhalt:

<?php
/**
* Register the templates
*/
TemplateLoader::addFiles(array
(
'hofff_shariff' => 'system/modules/hofff_shariff/templates',
'ce_hofff_shariff' => 'system/modules/hofff_shariff/templates',
'mod_hofff_shariff' => 'system/modules/hofff_shariff/templates',
));

Problem:

Offenbar wurden die Klassen nicht geladen.


Lösung:

Autoload-Creator von Contao die autoload.php ersetzen lassen und Systemwartung durchführen + Cache neu aufbauen.

Neuer config/autoload.php Inhalt:

<?php

/**
* Register the namespaces
*/
ClassLoader::addNamespaces(array
(
'Hofff',
));


/**
* Register the classes
*/
ClassLoader::addClasses(array
(
// Src
'Hofff\Contao\Shariff\BackendFactory' => 'system/modules/hofff_shariff/src/Hofff/Contao/Shariff/BackendFactory.php',
'Hofff\Contao\Shariff\ContentShariff' => 'system/modules/hofff_shariff/src/Hofff/Contao/Shariff/ContentShariff.php',
'Hofff\Contao\Shariff\ModuleShariff' => 'system/modules/hofff_shariff/src/Hofff/Contao/Shariff/ModuleShariff.php',
'Hofff\Contao\Shariff\Shariff' => 'system/modules/hofff_shariff/src/Hofff/Contao/Shariff/Shariff.php',
));


/**
* Register the templates
*/
TemplateLoader::addFiles(array
(
'ce_hofff_shariff' => 'system/modules/hofff_shariff/templates',
'hofff_shariff' => 'system/modules/hofff_shariff/templates',
'mod_hofff_shariff' => 'system/modules/hofff_shariff/templates',
));

Grüße,
Sluggish

[Contaona]

Weil's bei immer noch nicht funktioniert ... (Auf der Seite erscheint einfach nichts davon, auch keine leeren Container oder Sonstiges.)

Was genau hast du getan, als du festgestellt hast, dass die Klassen fehlten?
Ohne jegliche Dateiänderung den Autoload-Creator aufgerufen?

Wenn ich im Contao-Backend auf Autoload-Creator klicke,
in der angebotenen Liste bei hofff_shariff ein Häkchen setze und unten eins bei "Bestehende Dateien überschreiben" + Systemwartung..., dann tut sich bei mir genau gar nichts. Im Verzeichnis sind alle Dateien vom gleichen, alten Datum. Und im Code der Frontend-Seite tut sich genauso wenig.

[flx]

+1:
Ich hab das Modul nach der Anleitung in #1 erfolreich unter einem Contao 3.2.9 installiert.

Schritt 1: hofff_shariff nach system/modules/ hochladen (siehe Post #1)

Allerdings sollte auch der Ordner "endpoints" mitkopiert werden, er enthält die Logik für die
Zähler (counts.php)

Schritt 2: den Autoload Creator eine neue autoload.php erzeugen lassen, dann Systemwartung > internen Cache leeren

Schritt 3: FontAwesome, wenn nicht vorhanden, muss hier noch installiert werden (Fonts und CSS, CSS im Layout einbinden),
sonst fehlen die Social-Icons innerhalb der Shariff-Buttons.

Jetzt sind die Buttons in place und funktionieren. Allerdings funktionieren hier bei mir die Zähler noch nicht.
Ich hab mal probiert, in src/.../CountsController.php durch getShareCounts() zufällige Werte >0 ausgeben zu lassen.
Trotzdem erscheinen keine Zähler.

Hat jemand eine Lösung gefunden?

thx,
flx.

[hofff]

Ui ... dieser Thread ist ja komplett an mir vorbei gegangen, sorry.

Naja ... die manuelle Installation ist nicht ganz so einfach, auf Grund der ganzen Abhängigkeiten. Aber ein Ende ist in Sicht: noch im Januar werden wir unsere Downloadplattform veröffentlichen, wo ihr dann die Erweiterung als Paket zur manuellen Installation (inkl. aller abhängigen Erweiterungen) herunterladen könnt.

fg
nicky

[joseph.ki]

Bitte um Hilfe. Wo finde ich in der Erweiterung shariff den php-Code für das zu teilenende Bild sowie den Text und kann ich dies selbst beeinflussen?
Danke für Eure Hilfe.

[DePeder23]

Ich habe auch gerade shariff installiert (über den Contaomanager) – aber wo finde ich es anschließend in Contao? Bzw. wie kann ich es einsetzen? Ich habe irgendwie keine nachvollziehbare Anleitung gefunden.
Kann man damit auch Twitter-Streams DSGVO-konform einbinden? Oder dient es nur für "Teilen"-Buttons? Danke!

[Spooky]

Mit Shariff kannst du weder Twitter Feeds einbinden, noch etwas teilen. Das sind Like Buttons.

[DePeder23]

Mit Shariff kannst du weder Twitter Feeds einbinden, noch etwas teilen. Das sind Like Buttons.

Ah okay, vielen Dank!

[dackelchen]

Zum Einbinden: Entweder über das Modul, dass Dir nach der Installation zu Verfügung gestellt wird oder Du baust den Code direkt in das entsprechende Template ein.

Schau mal bei hofff.com. ob Du da eine Anleitung findest, ich meine, dass es dort eine gibt oder zumindest gab. Ich habe allerdings den Link dazu gerade nicht parat.

Es ist schon ein Weilchen her, dass ich die Erweiterung zu ersten Mal verbaut habe.