Templatetags for 'tweet this' and 'share on facebook'
Project description
Django Social Share
======================================
.. image:: https://travis-ci.org/fcurella/django-social-share.svg?branch=master
:target: https://travis-ci.org/fcurella/django-social-share
.. image:: https://coveralls.io/repos/github/fcurella/django-social-share/badge.svg?branch=master
:target: https://coveralls.io/github/fcurella/django-social-share?branch=master
Provides tempatetags for 'Tweet This', 'Share this on Facebook', 'Share on Google+' and 'mailto://'.
Installation
-------------
::
$ pip install django-social-share
Add the app to ``INSTALLED_APPS``::
INSTALLED_APPS += ['django_social_share']
You will also have to add ``django.core.context_processors.request`` to your ``context_processors`` list. This way the templatetags will use the correct scheme and hostname::
TEMPLATES=[
{
'BACKEND': 'django.template.backends.django.DjangoTemplates',
'DIRS': [
os.path.join(BASE_DIR, 'templates'),
],
'OPTIONS': {
'context_processors': [
'django.template.context_processors.request',
],
}
},
]
Usage
-----
::
{% post_to_facebook <object_or_url> <link_text> %}
{% post_to_gplus <object_or_url> <link_text> %}
{% post_to_twitter <text_to_post> <object_or_url> <link_text> %}
{% post_to_mail <email_subject> <text_to_post> <object_or_url> <link_text> %}
{% send_email <subject> <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'.
``<subject>`` may contain any valid Django Template code.
::
{% 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.
::
{% post_to_gplus_url <object_or_url> %}
Will add a ``gplus_url`` variable to the context, containing the URL for the Google+ sharer popup.
::
{% send_email_url <subject> <text_to_post> <object_or_url> <link_text> %}
Will add a ``mailto_url`` variable to the context, containing the URL for the ``mailto``anchor.
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" %}
{% post_to_gplus object_or_url "Post to Google+!" %}
{% send_email object.title "New Song: {{object.title}}. Check it out!" object_or_url "Share via email" %}
Templates are in ``django_social_share/templatetags/post_to_twitter.html``, ``django_social_share/templatetags/post_to_facebook.html`` and ``django_social_share/templatetags/post_to_gplus.html``, ``django_social_share/templatetags/send_email.html``. You can override them to suit your mileage.
======================================
.. image:: https://travis-ci.org/fcurella/django-social-share.svg?branch=master
:target: https://travis-ci.org/fcurella/django-social-share
.. image:: https://coveralls.io/repos/github/fcurella/django-social-share/badge.svg?branch=master
:target: https://coveralls.io/github/fcurella/django-social-share?branch=master
Provides tempatetags for 'Tweet This', 'Share this on Facebook', 'Share on Google+' and 'mailto://'.
Installation
-------------
::
$ pip install django-social-share
Add the app to ``INSTALLED_APPS``::
INSTALLED_APPS += ['django_social_share']
You will also have to add ``django.core.context_processors.request`` to your ``context_processors`` list. This way the templatetags will use the correct scheme and hostname::
TEMPLATES=[
{
'BACKEND': 'django.template.backends.django.DjangoTemplates',
'DIRS': [
os.path.join(BASE_DIR, 'templates'),
],
'OPTIONS': {
'context_processors': [
'django.template.context_processors.request',
],
}
},
]
Usage
-----
::
{% post_to_facebook <object_or_url> <link_text> %}
{% post_to_gplus <object_or_url> <link_text> %}
{% post_to_twitter <text_to_post> <object_or_url> <link_text> %}
{% post_to_mail <email_subject> <text_to_post> <object_or_url> <link_text> %}
{% send_email <subject> <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'.
``<subject>`` may contain any valid Django Template code.
::
{% 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.
::
{% post_to_gplus_url <object_or_url> %}
Will add a ``gplus_url`` variable to the context, containing the URL for the Google+ sharer popup.
::
{% send_email_url <subject> <text_to_post> <object_or_url> <link_text> %}
Will add a ``mailto_url`` variable to the context, containing the URL for the ``mailto``anchor.
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" %}
{% post_to_gplus object_or_url "Post to Google+!" %}
{% send_email object.title "New Song: {{object.title}}. Check it out!" object_or_url "Share via email" %}
Templates are in ``django_social_share/templatetags/post_to_twitter.html``, ``django_social_share/templatetags/post_to_facebook.html`` and ``django_social_share/templatetags/post_to_gplus.html``, ``django_social_share/templatetags/send_email.html``. You can override them to suit your mileage.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Close
Hashes for django-social-share-1.0.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | e1a1dfadc992c267d517ec7a757df4a066d95ad09b2af00ac88ff9870438936b |
|
MD5 | c50effe0e9afa5672f3d27ae91690a15 |
|
BLAKE2b-256 | d9bc5e2df8f9c30cb938add5417dc2b6b16d4194b6fed15d5008f066532024fc |
Close
Hashes for django_social_share-1.0.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | bebd6802068b8ff02cdcd0aa08c2165c569573deb030be9e01201e4886b0cf4c |
|
MD5 | eb94a1fff512387cf8927705b2bb8aeb |
|
BLAKE2b-256 | c75a8b169bd18f748fe0d442b0496beac30bd0df3bebc3abcc2ae321184eb6fb |