Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
An eggified model based BSD licensed social booking app for Django
Python
branch: master

This branch is 4 commits ahead of pydanny:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
social_bookmarking
.gitignore
CONTRIBUTORS.txt
LICENSE.txt
MANIFEST.in
README.rst
setup.py

README.rst

Django Social Bookmarking

A common use case in building applications is to provide links to social networking services. There are other Django apps that do this already, but they suffer from having the links stored statically and/or have licenses we can't use effectively in a US Federal government environment.

This solution provides the following:

  • A MIT license.
  • Target social bookmarking sites stored in a model
  • Admin tools
  • A fixture of 14 target sites
  • Icons for each of those target sites and many more
  • A test application to confirm that the basic view works
  • Eggification for easy installation and control

Installation

Install into your Python path. Tag coming soon for easy pip/easy_install.

Add 'social_bookmarking' to your INSTALLED_APPS in settings.py:

INSTALLED_APPS = (
    ...
    'social_bookmarking',
    )

If you have not yet done so, add 'django.core.context_processors.request' to the TEMPLATE_CONTEXT_PROCESSORS in your settings.py file:

TEMPLATE_CONTEXT_PROCESSORS = (
    ...
    'django.core.context_processors.request',
    )

Synch the database:

./manage.py syncdb

Load the fixtures:

./manage.py loaddata <location-of-django-social-bookmarking>/social_bookmarking/fixtures/bookmarks.json

Depending on your setup, you may need to copy the media files to your local media folder:

cp -R <location-of-django-social-bookmarking>/social_bookmarking/media/social_bookmarking <my-project>/media/

Usage

At the top of your page:

{% load social_bookmarking_tags %}

{% show_bookmarks object.title 'full-http-path-to-object' object.description %}

-- or --

{% show_bookmarks object.title object object.description %}

Note: The object.description field is optional.


Customizations

Django Social Bookmarking is designed to be easily customizable.

Skin Customizations

The most frequent customization will be on how links are displayed. Create a directory called social_bookmarking in your project's template directory. Then copy the HTML file social_bookmarking/templates/social_bookmarking/links.html to this project directory.

CSS customizations

The following classes and IDS are attached to the skin:

div.social-bookmarking
    span.bookmark #bookmark.title|slugify

Other classes and IDs will be assigned as requested by competent CSS designers.

Todo

  • Add more social networking sites
  • Validation existing social networking sites. Sounds like a test to me!
  • Full suite of tests against each site stored in the fixture.
  • Maybe some caching stuff?

Other Django Social Bookmarking applications

Django Social Bookmarking is a very rough fork of these two applications.

Something went wrong with that request. Please try again.