Skip to main content

Django-CMS plugin for Google Plus Activities

Project description

Django-cms plugin for fetching Google+ activities. You can find a preview at the bottom of this README.

Status

Still in Beta.

https://pypip.in/v/cmsplugin-googleplus/badge.png https://pypip.in/d/cmsplugin-googleplus/badge.png https://d2weczhvl823v0.cloudfront.net/itbabu/cmsplugin-googleplus/trend.png

Continuous Integration

https://secure.travis-ci.org/itbabu/cmsplugin-googleplus.png?branch=master Coverage

Install

  1. Install these packages and their requirements:

    NOTE: Django 1.6.x is supported only with Django-cms 3.x

  2. Install cmsplugin-googleplus in your environment.

Configure

  1. Configure django-cms

  2. Add cmsplugin_googleplus to the INSTALLED_APPS list in your project’s settings.py.

  3. Go to the google apis console and create a new project (a google account is required)

  4. Select Services and activate Google+ API

  5. Select API Access and get the API key

  6. Add the API key to your settings.py:

    GOOGLEPLUS_PLUGIN_DEVELOPER_KEY = '<your_api_key>'

Run

Fresh install

python manage.py syncdb --all
python manage.py migrate --fake

The first command will prompt you to create a super user. Choose ‘yes’ and enter appropriate values.

Upgrade

python manage.py syncdb
python manage.py migrate

How to use it

An activity is a note that a user posts to their stream. You can list a collection of activities from one user or you can list a collection of activities as result of a search.

Template

This plugin has an example template that uses Twitter Bootstrap 3. You can use it as skeleton for you templates.

Create your template and inside settings.py add:

GOOGLEPLUS_PLUGIN_TEMPLATES = (
    ('cmsplugin_googleplus/twitter_bootstrap.html',
     _('Example Template using Twitter Bootstrap')),
    ('path/to/my/template',
     _('My beautiful template'))
)

Cache

The activities are cached so you need to:

  1. Set up your cache system

  2. (Optional) Decide the activities cache duration. Default is 5 minutes. Inside settings.py add:

    GOOGLEPLUS_PLUGIN_CACHE_DURATION = <custom_cache_duration>

The actual ‘Courtesy Limit’ for the Google+ API is 10,000 requests/day

Translation

For translators I’ve set up a Transifex account where you can add languages and translate the .po

Tests

Requirements

Run the test with coverage

$ coverage run runtests.py && coverage report -m

Preview

This is how the plugin looks with the example template.

https://raw.github.com/itbabu/cmsplugin-googleplus/master/cmsplugin_googleplus/docs/images/cmsplugin-googleplus-preview.png

Have Fun!

Marco

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-googleplus-0.3.6b.tar.gz (29.0 kB view hashes)

Uploaded Source

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