cmsplugin-googleplus 0.3.2

Django-CMS plugin for Google Plus Activities

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

Still in Beta.

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

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

Tests

Requirements

• mock - 1.0.1

• django-nose - 1.2

• coverage - 3.6

Run the test with coverage

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

Preview

This is how the plugin looks with the example template.

Have Fun!