django-share-me-share-me 1.3

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:
```python
#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:

```python
#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
```html
#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