Download the PHP package fritzmg/contao-facebook-gallery without Composer

On this page you can find all versions of the php package fritzmg/contao-facebook-gallery. 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?

Informations about the package contao-facebook-gallery

Contao Facebook Gallery

Simple extension to allow the integration of a Facebook album via a gallery content element.

Usage

Facebook app

In order to be able to use the content element, you need to create a Facebook app first. Then you can define the Facebook app ID and App Secret in the system settings of Contao, or in the page root settings.

Album ID

Within the content element, you can simply provide the URL to the Facebook album, or its Facebook ID. If you provide the URL to the album, the album ID will be automatically extracted from the URL, if possible.

Access token

Important: due to changes in Facebook's API in 2018 you can no longer access public albums of pages without a valid access token. Otherwise you would have to submit the _Page Public Content Access_ app permission for review.

Thus since version 1.5.0 you have the ability to set a Facebook access token for each album. You can use this tutorial for example on how to create a Facebook Page access token that never expires. The basic steps are:

  1. Create a user access token for your Facebook app within Facebook's Graph Explorer. Important: you must require the manage_pages and the publish_pages permission. Otherwise you will be unable to generate an access token that never expires.
  2. Debug and extend the access token in Facebook's Access Token Debugger.
  3. Use the new access token in the Graph Explorer to make a query on /me/accounts.
  4. Copy the access token for the page from which you want to pull the album from and insert it into the content element.

Note: the Facebook user with which you create this access token must be administrator or developer of the Facebook app and he must be able to manage the album's Facebook page.

Image size

You can also define an image width and/or height (the image size mode will be ignored) - however, this will not be exact. Facebook (usually) provides differently sized images for each image of the album - the content element will try to find the smallest image that is at least as large as the given width and/or height. Thus you'll probably have to resize the images via CSS, to fit in your layout. Or change the gallery_default template and hardcode the given size as an inline style.

Additionally, a srcset from the available resolutions for each image will be created.

Sorting options

Since version 1.4.0 there is a sorting setting. Keep in mind that sorting by ID will only work on systems that use a 64-bit PHP environment, due to the large Facebook IDs.

Template data

For each image of the gallery, there is additional data available via $col->fbData. For example $col->fbData->id contains the Facebook ID of the image and $col->fbData->album->name contains the Facebook album's name. Since version 1.5.0 the Facebook data also contains the Facebook link of the image.

Notes

Acknowledgements

Development funded by Kosmopiloten.

All versions of contao-facebook-gallery with dependencies

PHP Build Version
Package Version
Requires php Version >=5.2
contao/core-bundle Version ^3.5 || ^4.4
contao-community-alliance/composer-plugin Version ^2.4 || ^3.0
fritzmg/contao-facebook-js-sdk Version ^3.1
facebook/graph-sdk Version ^5.7
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 fritzmg/contao-facebook-gallery contains the following files

Loading the files please wait ....