django-share-me-share-me

Model and front end library for choosing and integrating social media share widgets, similar to AddThis.

#Install

pip install django-share-me-share-me

#CMS Usage:

To make social settings administerable, include social_share_settings and rake the database:

#settings.py


	INSTALLED_APPS = (
    ...
    'share_me_share_me',
    ...
    )

> python manage.py schemamigration share_me_share_me --initial
> python manage.py migrate share_me_share_me

To make track social shares:

#urls.py
(r'^', include('share_me_share_me.urls')),    

#Template Usage: To output share icons based on the settings from the cms, use the "social_share_settings_tags" template tags. In this case I'm using "Font Awesome" to render the icons.

#social-share-partial.html
{% load share_me_share_me_tags %}

{% get_social_share_links as social_links %}

{% if social_links|length > 0 %}
<ul class="social sticky">
	{% for link in social_links %}
		{% get_social_share_link link object.get_absolute_url object.title as link_url %}
		<li>
			<a href="{{ link_url }}" target="_blank">
				<i class="fa fa-{{link.font_awesome_class}}"></i>
			</a>
		</li>
	{% endfor %}	
</ul>
{% endif %}

#Sticky Usage For sticky behavior, include or compile in the styles and javscript.

See screencast of sticky widget in action: http://screencast.com/t/Gm8Sah4IMQ

#base-template.html
<!-- Include Font Awesome  for easier social icons -->
<link href="//maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet" />

<!-- Include js plugin and css or compile into your source js -->
<link rel="stylesheet" href="{% static 'ccl/sticky.min.css' %}"/>
<script src="{% static 'js/sticky.jqueryplugin.js'%}"></script>
<script>
    $(".sticky").sticky({
        topSelector : "#main",
        bottomSelector : "#footer",
        fixedMargin : 160,
        topMargin : 0,
        bottomMargin : 0
    });
</script>

topSelector is the selector for the item the sticky widget should top-align with.

bottomSelector is the selector for the item the sticky widget should not go below.

topMargin refers to the top margin the sticky item will have when aligned to the top selector item

fixedMargin refers to the top margin the sticky item will have when the screen has scrolled past the top selector item

bottomMargin refers to the bottom margin the sticky item will have when aligned to the bottom selector item