X-Git-Url: https://git.mdrn.pl/django-pagination.git/blobdiff_plain/1df6507872d73ee387eb375428eafbfc253dfcd8..75011defd82708f0ee84e39a04aaf945c0e10ef1:/docs/usage.txt diff --git a/docs/usage.txt b/docs/usage.txt index 9c97c51..bb819b5 100644 --- a/docs/usage.txt +++ b/docs/usage.txt @@ -1,7 +1,7 @@ -How to use django-pagination +How to use linaro-django-pagination ---------------------------- -``django-pagination`` allows for easy Digg-style pagination without modifying +``linaro-django-pagination`` allows for easy Digg-style pagination without modifying your views. There are really 5 steps to setting it up with your projects (not including @@ -70,10 +70,20 @@ That's it! You have now paginated ``object_list`` and given users of the site a way to navigate between the different pages--all without touching your views. +A Note About Uploads +-------------------- + +It is important, when using linaro-django-pagination in conjunction with file uploads, +to be aware of when ``request.page`` is accessed. As soon as ``request.page`` +is accessed, ``request.upload_handlers`` is frozen and cannot be altered in any +way. It's a good idea to access the ``page`` attribute on the request object +as late as possible in your views. + + Optional Settings ------------------ -In django-pagination, there are no required settings. There are, however, a +In linaro-django-pagination, there are no required settings. There are, however, a small set of optional settings useful for changing the default behavior of the pagination tags. Here's an overview: