Added src and update to LICENSE.

Author: Marco Pompili

.gitignore

@@ -1,4 +1,11 @@
 *.log
 *.pot
 *.pyc
-local_settings.py
+
+.project
+.pydevproject
+.settings
+.idea
+
+dist
+django_instagram.egg-info

LICENSE

@@ -11,7 +11,7 @@ are permitted provided that the following conditions are met:
   list of conditions and the following disclaimer in the documentation and/or
   other materials provided with the distribution.
 
-* Neither the name of the {organization} nor the names of its
+* Neither the name of the emarcs.org nor the names of its
   contributors may be used to endorse or promote products derived from
   this software without specific prior written permission.
 

MANIFEST.in

@@ -0,0 +1,6 @@
+include LICENSE
+include README.rst
+include README.md
+recursive-include django_instagram/templates *
+recursive-include django_instagram/static *
+recursive-include docs *

README.md

@@ -1,4 +1,52 @@
 django-instagram
 ================
 
-Django instagram application based on the python-instagram API.
+Django Instagram application based on the python-instagram API.
+
+Requirements
+------------
+- [Django 1.5](https://www.djangoproject.com/)
+- [Python Instagram API](https://github.com/Instagram/python-instagram)
+
+
+Installation
+------------
+Install django from your favourite package system if you can find it. Or you can use pip for installing python packages that are not listed in the package system of your distribution:
+- Install the python-instagram API.
+```
+pip install python-instagram
+```
+- Install the django-instagram.
+
+After you cloned the repository, to install this python application you can use the pip command to install local applications like this:
+```
+pip -e install django-instagram
+```
+
+Configuration
+-------------
+Add the application to INSTALLED_APPS:
+```python
+INSTALLED_APPS = (... 'django_instagram' ...)
+```
+
+Then go to the administration and click on "Get Access Token" to (of course) receive your access token from Instagram. Then copy it to the configuration field and save. Remember to be logged in with the Instagram account that you want to get the access token for.
+
+Usage
+-----
+After you are done with this, you can use the tags who need user access to Instagram, like:
+```
+{% instagram_recent_media %}
+```
+This tag will give you a context variable called: 'recent_media'
+
+To get instagram popular media you don't need an access token instead, so you can ignore the last configuration step above.
+```
+{% instagram_popular_media %}
+```
+This tag will give you a context variable callde: 'popular_media'
+
+There's also another inclusion tag that includes an example of how to parse instagram data:
+```
+{% instagram_popular_media_box %}
+```

README.rst

@@ -0,0 +1,73 @@
+"""
+Created on 15/dic/2013
+
+@author: Marco Pompili
+"""
+
+from django.contrib import admin
+from django.utils.translation import ugettext_lazy as _
+
+from django.db import transaction
+from django.utils.decorators import method_decorator
+from django.views.decorators.csrf import csrf_protect
+
+from .models import InstagramConfiguration
+from .templatetags import instagram_client
+
+
+csrf_protect_m = method_decorator(csrf_protect)
+
+instagram_extra_content = {
+    "client_id": instagram_client.DJANGO_INSTAGRAM_CLIENT_ID,
+    "redirect_uri": instagram_client.DJANGO_INSTAGRAM_REDIRECT_URI
+}
+
+
+class InstagramAdmin(admin.ModelAdmin):
+    fieldsets = (
+        (_(u'Django Instagram Configuration'),
+         {
+             'fields': ('app_access_token',)
+         }),
+    )
+
+    def has_add_permission(self, request):
+        """
+        Just let to add the configuration once.
+        :param request:
+        :return:
+        """
+        return not InstagramConfiguration.objects.exists()
+
+    def add_view(self, request, form_url='', extra_context=None):
+        """
+        Add extra parameters from the settings (client_id, redirect_uri) into the add view.
+        :param request:
+        :param form_url:
+        :param extra_context:
+        :return:
+        """
+        return admin.ModelAdmin.add_view(self,
+                                         request,
+                                         form_url='',
+                                         extra_context=instagram_extra_content)
+
+    @csrf_protect_m
+    @transaction.atomic
+    def change_view(self, request, object_id, form_url='', extra_context=None):
+        """
+        Add extra parameters from the settings (client_id, redirect_uri) into the change_view.
+        :param request:
+        :param object_id:
+        :param form_url:
+        :param extra_context:
+        :return:
+        """
+        return admin.ModelAdmin.change_view(self,
+                                            request,
+                                            object_id,
+                                            form_url=form_url,
+                                            extra_context=instagram_extra_content)
+
+
+admin.site.register(InstagramConfiguration, InstagramAdmin)

django_instagram/__init__.py

@@ -0,0 +1,19 @@
+"""
+Created on 13/mar/2014
+
+@author: Marco Pompili
+"""
+
+from django.db import models
+from django.utils.translation import ugettext_lazy as _
+
+
+class InstagramConfiguration(models.Model):
+    class Meta:
+        verbose_name = _(u"Django Instagram Configuration")
+        verbose_name_plural = _(u"Django Instagram Configuration")
+
+    app_access_token = models.TextField(
+        _(u'Access token'),
+        help_text=_(
+            u'Click on "Get Access Token" and you will be redirected to Instagram, then follow the instructions. Remember to log in with the user that you want to show on the web page.'))

django_instagram/admin.py

@@ -0,0 +1,16 @@
+.django_instagram {
+    position: relative;
+}
+
+.django_instagram .slider {
+    position: relative;
+    margin: 0; padding: 0;
+    list-style: none
+}
+
+.django_instagram .entry {
+    position: absolute;
+    top:0; left: 50%;
+    margin-left: -153px;
+    display: none
+}

django_instagram/models.py

@@ -0,0 +1,17 @@
+.django_instagram_media_wall_item {
+    width:  25%; height: auto;
+    float: left;
+    position: relative
+}
+
+.django_instagram_media_wall_item img {
+    width: 100%; height: auto;
+    float: left
+}
+
+.django_instagram_media_wall_item a span {
+    position: absolute;
+    bottom: 0; left: 0; right: 0;
+    color: #F3F3F3; background: #222222; opacity: 0.8;
+    z-index: 50
+}