cmsplugin-googleplus 0.3.6b

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.

Status

Still in Beta.

Continuous Integration

Install

1. Install these packages and their requirements:

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

   • Django>=1.4

   • django-cms>=2.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 ‘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

• mock - 1.0.1

• django-nose - 1.2

• coverage - 3.7

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!

Marco