Source

django-dynamic-link / README.rst

Description

Django file streaming application to provide download links without showing the real path to the served file. The links can be set to expire by date or by clicks. It is also possible to use it for counting clicks on a download link.

License

New BSD license

Notes

  • Tested with Django 1.2 / 1.3 / 1.4
  • Example project is included (configured for Django 1.4)

Features

  • Link expires by clicks (optional)
  • Link expires by time (optional)
  • Is usable for counting clicks

Installation

Dependences

  • This app
  • Django itself, its redirects from django.contrib and its locale middleware.

Installation

Installation with pip (recommended)

Pip will download and install the package and take care of all the dependences. If you havn't pip on your system then install setuptools first after that run "easy_install pip". After that you can use pip in your terminal window.

  • Use the stable release (recommended):

    pip install django-dynamic-link
    
  • Or the development version:

    pip install -e hg+https://bitbucket.org/catapela/django-dynamic-link/#egg=django-dynamic-link
    
  • With pip you can also uninstall:

    pip uninstall django-dynamic-link
    

other Installation methodes

First of all download the package from pypi (stable) or bitbucket (development). Find a download location here.
  • Either copy the sources in your project root

    1. Unpack your package.
    2. Copy the folder "dynamic_link" in your project root.
    3. Make sure all package dependences are fulfilled.
  • Or use setup.py

    1. Unpack your package.
    2. Open a terminal and change to the folder which contains the setup.py and type
    python setup.py install
    

test your installation

Go to console and type:

python

... then type:

>>> import dynamicLink
>>> dynamicLink.CKINST()
>>> dynamicLink.VERSION
>>> dynamicLInk.REQUIRES
>>> help(dynamicLink)
>>> exit()

Setup

  • Add "dynamicLink" to you installed apps in the settings file.

  • Make sure that:

    1. 'django.middleware.locale.LocaleMiddleware', is in your MIDDLEWARE_CLASSES.
    2. Your Admin is enabled ('django.contrib.admin', is in your INSTALLED_APPS).
    3. 'django.contrib.auth.context_processors.auth', (also for admin) is in TEMPLATE_CONTEXT_PROCESSORS.
    4. 'django.core.context_processors.request', is in TEMPLATE_CONTEXT_PROCESSORS.
  • Add the following to your urls.py:

    1. from dynamicLink import presettings
    2. (r'^w+/%s/' % presettings.DYNAMIC_LINK_URL_BASE_COMPONENT, include('dynamicLink.urls')),
  • Finally run:

    python manage.py syncdb
    python manage.py runserver
    

Make it custom

Use the global settings.py in your projects root to overwrite the applications presettings with the following variables.

DYNAMIC_LINK_MEDIA

  • Default: settings.MEDIA_ROOT
  • A path to a directory. From this point you can walk down the subdirectories to choose your files to serve.

DYNAMIC_LINK_URL_BASE_COMPONENT

Usage

Open the admin interface and go to "Dynamiclink" section. The rest should be self-explanatory.

Hints

  • Zero value for link age means never expires.
  • Zero value for clicks means unlimited clicks.
  • If a link never expires you can use it for click counting.
  • Trough the action menu you can serve a site with several links.
  • The filename from the created links are only for human readability. You can delete or change these filenames in any way you want.

Example project

djang-dynamic-links ships with an example proect.

  1. First you need the example project folder which is shipped within the package. See the "other Installation methodes" section above to find out where to download it.
  2. After you got the desired package install it (see install section).
  3. Next you have to extract the example folder within the package to any location you want.
  4. Open a terminal and change directory into the previous extracted example folder
cd /path/to/example
  1. After that run
python manage.py syncdb
python manage.py runserver
  1. Finaly open a Browser and go to: http://127.0.0.1:8000/
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.