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

Continuous Integration

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

Install

  1. Install these packages and their requirements:

  2. Install cmsplugin-googleplus in your environment.

Configure

  1. Configure django-cms

  2. Add cmsplugin_googleplus and 'django.contrib.humanize' 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.

Example Template

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

As quickstart you can use a CDN for the related css:

<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.1.1/css/bootstrap.min.css">
<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.1.1/css/bootstrap-theme.min.css">

and the related javascript:

<script src="http://code.jquery.com/jquery.js"></script>
<script src="//maxcdn.bootstrapcdn.com/bootstrap/3.1.1/js/bootstrap.min.js"></script>

Custom Template

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

Project details


Release history Release notifications

History Node

0.7.0

History Node

0.6.0

History Node

0.5.2

History Node

0.5.0

This version
History Node

0.4.0

History Node

0.3.6

History Node

0.3.6b

History Node

0.3.5

History Node

0.3.4

History Node

0.3.2

History Node

0.3.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
cmsplugin_googleplus-0.4.0-py2-none-any.whl (40.0 kB) Copy SHA256 hash SHA256 Wheel 2.7 Jun 19, 2014
cmsplugin-googleplus-0.4.0.tar.gz (29.2 kB) Copy SHA256 hash SHA256 Source None Jun 19, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page