Download the PHP package schachbulle/contao-tiktok-bundle without Composer

On this page you can find all versions of the php package schachbulle/contao-tiktok-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of schachbulle/contao-tiktok-bundle

Informations about the package contao-tiktok-bundle

Contao TikTok Bundle

Inhaltselement für Contao 4.13 und Contao 5, das ein einzelnes TikTok-Video anzeigt. Es genügt der Link zum Video. Ein API-Schlüssel oder eine Registrierung bei TikTok ist nicht nötig.

Voraussetzungen

Installation

Danach die Datenbank aktualisieren (Contao Manager oder contao:migrate). Das Bundle ergänzt in tl_content die Felder tiktokUrl und tiktokOptions.

Verwendung

Das Inhaltselement TikTok steht in der Typauswahl in der Gruppe „Medienelemente“ neben YouTube und Vimeo.

Feld Bedeutung
Link zum Video Link der Form https://www.tiktok.com/@konto/video/7123…, ein Kurzlink (https://vm.tiktok.com/…) oder die bloße Videonummer
Player-Optionen Automatisch abspielen, Endlosschleife, Beschreibung einblenden, Angaben zur Musik einblenden, am Ende keine weiteren Videos vorschlagen

Ein Kurzlink enthält keine Videonummer. Er wird beim Speichern einmalig über die oEmbed-Schnittstelle von TikTok aufgelöst und durch den vollständigen Link ersetzt. Im Frontend findet danach kein Aufruf vom Server zu TikTok mehr statt.

Abgewiesen werden beim Speichern fremde Adressen sowie Links, die kein einzelnes Video bezeichnen (Profile, Foto-Beiträge).

Ausgabe

Das Video erscheint sofort mit dem Seitenaufbau im Einbettungsplayer von TikTok (https://www.tiktok.com/player/v1/<Videonummer>), ohne vorgeschalteten Klick:

Im Backend zeigt die Elementliste statt des Players nur den eingetragenen Link.

Größe und Abstand anpassen

Die mitgelieferte Stildatei bundles/contaotiktok/tiktok.css gibt dem Player das Hochformat 9:16 und höchstens 325 Pixel Breite. Unter dem Element bleiben 20 Pixel Abstand zum nächsten Element. Beides lässt sich im eigenen Stylesheet über CSS-Variablen ändern:

Variable Vorgabe Bedeutung
--tiktok-breite 325px Größte Breite des Players; die Höhe folgt aus dem Seitenverhältnis
--tiktok-abstand 20px Außenabstand unter dem Element (margin-bottom); 0 schaltet ihn ab

Setzt das eigene Stylesheet für .ce_tiktok selbst ein margin-bottom, gilt dieser Wert — die Stildatei des Bundles wird vor den Stylesheets des Seitenlayouts geladen.

Template

Das Template heißt ce_tiktok und lässt sich wie üblich im Ordner templates überschreiben oder am Element durch ein eigenes ce_tiktok_… ersetzen. Es bekommt playerUrl (für HTML maskiert), videoId und frameTitle.

Datenschutz

Der Browser des Besuchers lädt den Player unmittelbar von tiktok.com; dabei erfährt TikTok mindestens die IP-Adresse und die aufrufende Seite. Der Player blendet im Geltungsbereich der DSGVO seinen eigenen Cookie-Hinweis ein. Eine vorgeschaltete Einwilligung („Zwei-Klick-Lösung“) bringt das Bundle bewusst nicht mit. Wer sie braucht, hängt sie über ein eigenes Template oder ein Consent-Werkzeug davor.

Entwicklung

Unit-Tests (ohne Contao-Installation und ohne Netzwerk):

Prüfstand gegen eine Contao-Installation, in die das Bundle als Pfad-Paket eingebunden ist (Container-Cache vorher leeren):

Aufbau

Datei Aufgabe
src/Tiktok/VideoLink.php Liest die Videonummer aus Links, baut die Player-Adresse; ohne Contao, ohne Netzwerk
src/EventListener/VideoLinkListener.php save_callback an tl_content.tiktokUrl: prüft den Link, löst Kurzlinks über oEmbed auf
src/ContentElements/Tiktok.php Das Inhaltselement (klassisch über $GLOBALS['TL_CTE'], läuft so unter 4.13 und 5)
src/Resources/contao/templates/ce_tiktok.html5 Frontend-Template
src/Resources/public/tiktok.css Seitenverhältnis und Breite des Players, Abstand zum nächsten Element

Lizenz

LGPL-3.0-or-later

All versions of contao-tiktok-bundle with dependencies

PHP Build Version
Package Version
Requires php Version ^7.4 || ^8.0
contao/core-bundle Version ^4.13 || ^5.0
symfony/http-client Version ^5.4 || ^6.0 || ^7.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package schachbulle/contao-tiktok-bundle contains the following files

Loading the files please wait ...