Skip to main content

Templatetags for 'tweet this' and 'share on facebook'

Project description

Provides tempatetags for ‘Tweet This’ and ‘Share this on Facebook’.

Installation

$ pip install django-social-share

Add the app to INSTALLED_APPS:

INSTALLED_APPS += ['django_social_share']

It’s recommended to add django.core.context_processors.request to your `` TEMPLATE_CONTEXT_PROCESSORS`` list. This way the templatetags will use the correct scheme and hostname.

If django.core.context_processors.request is not present, it will simply concatenate the current site’s domain (from django.contrib.sites) and the object’s relative URL together.

Usage

{% post_to_facebook <object_or_url> <link_text> %}

{% post_to_twitter <text_to_post> <object_or_url> <link_text> %}

<text_to_post> may contain any valid Django Template code. Note that Facebook does not support this anymore.

<object_or_url> is optional. If you pass a django model instance, it will use its get_absolute_url method. Additionally, if you have django_bitly installed, it will use its shortUrl on Twitter.

<link_text> is also optional. It defines the text used for the a element. Defaults to ‘Post to Facebook’ and ‘Post to Twitter’

{% post_to_twitter_url <text_to_post> <object_or_url> %}

Will add a tweet_url variable to the context, containing the URL for the Twitter sharer popup.

{% post_to_facebook_url <object_or_url> %}

Will add a facebook_url variable to the context, containing the URL for the Facebook sharer popup.

Example:

{% load social_share %}

{% post_to_facebook object_or_url "Post to Facebook!" %}
{% post_to_twitter "New Song: {{object.title}}. Check it out!" object_or_url "Post to Twitter" %}

Templates are in django_social_share/templatetags/post_to_twitter.html and django_social_share/templatetags/post_to_facebook.html. You can override them to suit your mileage.

Project details


Download files

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

Source Distribution

django-social-share-0.2.0.tar.gz (4.0 kB view details)

Uploaded Source

File details

Details for the file django-social-share-0.2.0.tar.gz.

File metadata

File hashes

Hashes for django-social-share-0.2.0.tar.gz
Algorithm Hash digest
SHA256 effaefebaac4f9a1ab3b85125a1ddc3f9a1bcf63852c9490d1ad68eb15625d69
MD5 665672f68179d281ff3bb027cb6428ec
BLAKE2b-256 e88cb7856c8e0f01b9dde361e4696df10b76ca5af6423dc0e60920e6be77e037

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page