Skip to main content

facebook gallery plugin for django-cms

Project description

[![Stories in Ready](https://badge.waffle.io/changer/cmsplugin-fbgallery.png?label=ready&title=Ready)](https://waffle.io/changer/cmsplugin-fbgallery)
cmsplugin-fbgallery
===================

[![Build Status](https://travis-ci.org/changer/cmsplugin-fbgallery.png?branch=master)](https://travis-ci.org/changer/cmsplugin-fbgallery)

Django CMS plugin for facebook album gallery

This projects helps integrate Facebook album into your Django CMS based website. The plugin provide superb performance compared to the Ajax based alternatives and works even on IE > 6 without any issues. Also, with caching enabled it loads fast without any lag.


## Installation:

Add the following line into your `requirements.txt` file:

```bash
https://github.com/changer/cmsplugin-fbgallery/archive/v1.0.2.zip
```
And add the Facebook App ID and Secret in your settings file:

```py
INSTALLED_APPS = (
`cmsplugin_fbgallery`,
)

FB_APP_ID = os.environ.get('FB_APP_ID')
FB_APP_SECRET = os.environ.get('FB_APP_SECRET')

```

Since this is secret information, we encourage to keep the secret out of source control. This also allows easy configuration on platforms like heroku. You can obtain the Facebook App ID and Secret by creating an app at [facebook for developers](developers.facebook.com)


Once done, add a block into the django template where you want to use the plugin to work, preferably in
base.html:

```html
{% placeholder facebook-gallery %}
```

## Usage:

In order to use, add the plugin into the intended placeholder and add facebook album Id in the admin and save the plugin and page. Once done, you will have the gallery up and running for you.

### Finding Album ID:

A facebook Album URL contains the information about the Album ID, here is how you get the Album ID:

If URL is: https://www.facebook.com/pagename/photos/?tab=album&album_id=1234567890

Your Album ID is: 1234567890 .

## Scope:

The future versions with bring in more cleanup and fixes to the plugin.

## Bugs/Issues:

Create an issue here with proper detail: https://github.com/changer/cmsplugin-fbgallery/issues


## Inspirations/Credits:

This projects seeks some inspirations from the work of [@dantium](https://github.com/dantium) and [@driesdesmet](https://github.com/driesdesmet) on django-fbgallery but adapts it to more CMS plugin way.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cmsplugin-fbgallery-1.1.0.tar.gz (6.2 kB view details)

Uploaded Source

File details

Details for the file cmsplugin-fbgallery-1.1.0.tar.gz.

File metadata

File hashes

Hashes for cmsplugin-fbgallery-1.1.0.tar.gz
Algorithm Hash digest
SHA256 083836bba4d377455d76d74b70b4a6d125f056ecc04bb367a6a8e0bd6c8c3437
MD5 eca2a7c7717d15670a12a72d3c487974
BLAKE2b-256 8199b90e5ababe4d0b5bd6a956f11880961eba18a62b6c2cc610429577327ffe

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page