cmsplugin-googleplus 0.3.2 (beta)

Django-CMS plugin for Google Plus Activities

Continuous Integration

Install

1. Install these packages and their requirements:

• django-cms
• Django>=1.4
• google-api-python-client - 1.2
• python-dateutil - 2.1

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

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

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 quota limits for the google+ api are 10,000 requests/day

Tests

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

Preview

This is how the plugin looks with the example template.

Have Fun!