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

On this page you can find all versions of the php package schachbulle/contao-instagram-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-instagram-bundle

Informations about the package contao-instagram-bundle

Contao Instagram Bundle

Inhaltselement für Contao 4.13 und Contao 5, das einen einzelnen Instagram-Beitrag (Foto, Reel oder Video) anzeigt. Es genügt der Link zum Beitrag. Eine Facebook-App oder ein Zugriffsschlüssel ist nicht nötig.

Voraussetzungen

Installation

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

Verwendung

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

Feld Bedeutung
Link zum Beitrag Link der Form https://www.instagram.com/p/…/, …/reel/…/ oder …/tv/…/, auch mit Kontonamen davor
Bildunterschrift anzeigen Blendet den Text des Beitrags unter dem Bild oder Video ein

Beim Speichern wird der Link vereinheitlicht: Der Kontoname im Pfad und angehängte Parameter (?igsh=…, ?utm_source=…) fallen weg, gespeichert wird https://www.instagram.com/p/<Kurzcode>/.

Nicht unterstützt werden Teilen-Links (https://www.instagram.com/share/…): Sie enthalten den Kurzcode des Beitrags nicht. Den richtigen Link liefert Instagram im Browser in der Adresszeile des geöffneten Beitrags oder über „Link kopieren“. Ebenfalls abgewiesen werden Profile, Storys und fremde Adressen.

Ausgabe

Das Element gibt den Beitrag in der Form aus, die Instagram unter „Einbetten“ selbst erzeugt. Das Skript embed.js von Instagram ersetzt das blockquote beim Laden der Seite durch den Beitrag und passt dessen Höhe an; der Beitrag erscheint sofort, ohne vorgeschalteten Klick:

Das Skript wird je Seite nur einmal eingebunden (am Ende des body), auch wenn mehrere Beiträge auf der Seite stehen. Der Link im blockquote bleibt sichtbar, falls das Skript nicht lädt.

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

Breite und Abstand

Das Bundle bringt die Stildatei bundles/contaoinstagram/instagram.css mit und bindet sie je Seite einmal ein. Sie regelt zweierlei:

Beides lässt sich im eigenen Stylesheet über CSS-Variablen einstellen. Beim Abstand schaltet der Wert 0 ihn ab, bei der Breite sind auch Werte über 540 Pixel möglich:

Die Stildatei steht vor denen des Themes; eine eigene Regel .ce_instagram { margin-bottom: … } überschreibt sie deshalb ebenfalls.

Template

Das Template heißt ce_instagram und lässt sich wie üblich im Ordner templates überschreiben oder am Element durch ein eigenes ce_instagram_… ersetzen. Es bekommt permalink (für HTML maskiert), embedVersion, captioned und linkText.

Datenschutz

Der Browser des Besuchers lädt Skript und Beitrag unmittelbar von instagram.com; dabei erfährt Meta mindestens die IP-Adresse und die aufrufende Seite. 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/Instagram/PostLink.php Bildet Links auf die einheitliche Adresse des Beitrags ab; ohne Contao, ohne Netzwerk
src/EventListener/PostLinkListener.php save_callback an tl_content.instagramUrl: prüft und vereinheitlicht den Link
src/ContentElements/Instagram.php Das Inhaltselement (klassisch über $GLOBALS['TL_CTE'], läuft so unter 4.13 und 5)
src/Resources/contao/templates/ce_instagram.html5 Frontend-Template
src/Resources/public/instagram.css Breite des Beitrags und Abstand zum nächsten Element

Lizenz

LGPL-3.0-or-later

All versions of contao-instagram-bundle with dependencies

PHP Build Version
Package Version
Requires php Version ^7.4 || ^8.0
contao/core-bundle Version ^4.13 || ^5.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-instagram-bundle contains the following files

Loading the files please wait ...