Metadata-Version: 1.0
Name: django-mailru-money
Version: 0.1.2
Summary: Приложение для подключения сайта к деньгам@mail.ru
Home-page: https://bitbucket.org/kmike/django-mailru-money/
Author: Mikhail Korobov
Author-email: kmike84@gmail.com
License: MIT license
Description: ===================
        django-mailru-money
        ===================
        
        django-mailru-money - это приложение для подключения django-сайта
        к платежной системе `деньги@mail.ru <http://money.mail.ru/>`_.
        
        Лицензия - MIT.
        Поддерживается python 2.6, 2.7 и 3.2; django 1.3 и 1.4.
        
        Установка
        =========
        
        ::
        
            $ pip install django-mailru-money
        
        В settings.py пропишите данные своего магазина::
        
            MAILRU_MONEY_SHOP_ID = 'my_shop_id'
            MAILRU_MONEY_SECRET_KEY = 'my_secret_key'
        
        Подключите обработчик приема платежей в urls.py::
        
            urlpatterns = patterns('',
                # ...
                url(r'^mailru-money/', include('mailru_money.urls')),
                # ...
            )
        
        ResultURL (который нужно сообщить в money.mail.ru) в этом случае
        будет ``http://your-site.com/mailru-money/result/``.
        
        Затем добавьте ``'mailru_money'`` в INSTALLED_APPS и выполните syncdb
        (migrate, если используется South).
        
        В INSTALLED_APPS также должны быть ``'django.contrib.auth'``
        и ``'django.contrib.contenttypes'``.
        
        Использование
        =============
        
        На странице оплаты используйте ``mailru_money.forms.MailruOrderForm``
        для вывода формы оплаты и формирования заказа::
        
            # views.py
            from django.shortcuts import get_object_or_404, render
            from mailru_money.forms import MailruOrderForm
            from myapp.models import Item
        
            @login_required
            def pay(request, item_id)
        
                # товар, который будем оплачивать
                item = get_object_or_404(Item, id=item_id)
        
                # создаем заказ
                form = MailruOrderForm(
                    amount = item.price,
                    description = item.description,
                    user = request.user
                    pay_for = item,
                )
        
                return render(request, 'myapp/pay.html', {'form': form})
        
        В шаблоне требуется сформировать форму оплаты::
        
            {# myapp/pay.html #}
            {# ... #}
        
            <form method='post' action='{{ form.ACTION }}'>
                {{ form }}
                <input type='submit' value='Оплатить через Деньги@mail.ru'>
            </form>
        
            {# ... #}
        
        Обратите внимание, что {% csrf_token %} использовать не нужно.
        Форма будет выведена как набор скрытых полей.
        
        Обработку платежей можно осуществлять в сигнале
        ``mailru_money.signals.order_status_changed``::
        
            from mailru_money.models import MailruOrder
            from mailru_money.signals import order_status_changed
        
            from myapp.models import Item
        
            def mailru_payment_received(sender, order, old_status, **kwargs):
                item = order.pay_for
                if order.state == MailruOrder.PAID:
                    item.deliver_to(order.user)
                elif order.state == MailruOrder.REJECTED:
                    item.unblock()
        
            order_status_changed.connect(mailru_payment_received)
        
        Сигнал шлется только когда у заказа изменился статус. Оплаченный заказ при
        этом стать неоплаченным не может.
        
        django-mailru-money поддерживает и другую схему работы
        (можно не использовать встроенные средства для контроля заказов).
        См. исходный код, если описанная выше схема не устраивает.
        
        Разработка
        ----------
        
        Разработка идет на bitbucket.org и github.com:
        
        * https://bitbucket.org/kmike/django-mailru-money/
        * https://github.com/kmike/django-mailru-money/
        
        Баг-трекер - на битбакете: https://bitbucket.org/kmike/django-mailru-money/issues/new
        
        Для запуска тестов склонируйте репозиторий, установите `tox <http://tox.testrun.org>`_
        и запустите
        
        ::
        
            $ tox
        
        из корня репозитория.
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.2
Classifier: Topic :: Software Development :: Libraries :: Python Modules
