skip to navigation
skip to content

Not Logged In

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.

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

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

 
File Type Py Version Uploaded on Size
cmsplugin-googleplus-0.3.6b.tar.gz (md5) Source 2013-12-14 28KB
  • Downloads (All Versions):
  • 36 downloads in the last day
  • 234 downloads in the last week
  • 1008 downloads in the last month