Введение
В первой части данной серии мы создали голый костяк сайта с подписками на основе Laravel. Так же, мы создали сайт с ролями и создали распределение ролей для зарегистрированных пользователей. Теперь мы подошли к тому моменту, где мы можем создать и выполнить регистрацию, авторизацию и выход.
В этой части мы будем интегрировать Recurly для настройки наших платных планов членства.
Приступаем к работе
Есть две библиотеки Recurly — клиентская библиотека PHP, которую мы ранее установили с помощью composer (в первой части) и Recurly JS. Recurly JS — это клиентская библиотека для динамической интеграции формы, которая безопасно обрабатывает информацию с карт.
Информация карт размещается на серверах Recurly, а не в нашем веб-приложении, что уменьшает нашу головную боль.
Скачаем библиотеку Recurly JS и скопируем recurly.min.js из папки сборки в папку public/js/libs и добавим его в макете перед закрывающим тегом:
<script src="/js/libs/recurly.min.js"></script> </body>
Мы также должны использовать CSS-стили, которые используются для отображения формы оплаты. Создайте каталог в директории css/recurly и скопируйте в него директорию themes, а затем мы будем ссылаться на него в соответствующем разделе нашего макета
<link href="/css/recurly/themes/default/recurly.css" rel="stylesheet">
Когда вы первый раз залогинитесь после создания учетной записи с Recurly, вам предложат создать свои планы подписок. В первой части мы создали три разных уровня подписок — бронза, серебро и золото. Вы всегда можете изменить их или добавить новые, но нет никакого вреда в том, что мы сделаем это сейчас.
Создайте план под названием Бронзовый; Будьте внимательны, нужно что бы план кода был установлен “bronze” (в нижнем регистре). Установить цену — я написал £ 4,99 в месяц, но вы можете выбрать любую сумму и / или сроки, которые вам нравится. При необходимости вы можете установить одноразовую плату или бесплатный ознакомительный период.
Повторите процесс еще два раза для настройки серебряного (код: «silver») и золотого (код: «gold») планов. Я установил минимум при £ 9.99 и £ 14,99 в месяц соответственно максимум.
Теперь перейдите в админ-панель Recurly, где есть несколько вещей, которые мы должны настроить, а также найти необходимую информацию для настройки вашего приложения. Нажмите доступ API на левой стороне. Щелкните Включить доступ API. Запишите свой ключ API, и ваш поддомен.
Теперь перейдите в Recurly.js на левой стороне (под Разработчик (Developer)). Щелкните Включить Recurly.js и Transparent Post API. Запишите ваш секретный ключ.
Теперь создайте файл конфигурации Recurly в папке app/config/recurly.php, заменяя значения с теми, которые вы только что записали вместе с трехзначным кодом, который отображает выбранную вами валюту по умолчанию (например, USD, GBP, AUD):
<?php return array( 'api_key' => 'YOUR-API-KEY', 'private_key' => 'YOUR-PRIVATE-KEY', 'subdomain' => 'YOUR-SUBDOMAIN', 'default_currency' => 'XYZ' );
Теперь перейдем к всплывающим уведомлениям на левой стороне. Нажмите кнопку настроить. Введите URL адрес вашего приложения включая /recurly, например www.example.com/recurly. Оставьте поля HTTP авторизация Имя пользователя (Username) и HTTP авторизация пароля (Password) пустыми на данный момент.
Страница регистрации
Теперь, давайте создадим страницу регистрации, которая позволит потенциальным клиентам выбирать для себя план. Создайте по этому пути app/views/home файл signup.blade.php со следующим содержанием:
@extends('layouts.default') @section('content') <h1>Signup</h1> <p>Please select your plan...</p> <div class="row-fluid pricing-table pricing-three-column"> <div class="span4 plan"> <div class="plan-name-bronze"> <h2>Bronze</h2> <span>£4.99 / Month</span> </div> <ul> <li class="plan-feature">Feature #1</li> <li class="plan-feature">Feature #2</li> <li class="plan-feature"><a href="/user/register/bronze" class="btn btn-primary btn-plan-select"><i class="icon-white icon-ok"></i> Select</a></li> </ul> </div> <div class="span4 plan"> <div class="plan-name-silver"> <h2>Silver <span class="badge badge-warning">Popular</span></h2> <span>£9.99 / Month</span> </div> <ul> <li class="plan-feature">Feature #1</li> <li class="plan-feature">Feature #2</li> <li class="plan-feature"><a href="/user/register/silver" class="btn btn-primary btn-plan-select"><i class="icon-white icon-ok"></i> Select</a></li> </ul> </div> <div class="span4 plan"> <div class="plan-name-gold"> <h2>Gold</h2> <span>£4.99 / Month</span> </div> <ul> <li class="plan-feature">Feature #1</li> <li class="plan-feature">Feature #2</li> <li class="plan-feature"><a href="/user/register/gold" class="btn btn-primary btn-plan-select"><i class="icon-white icon-ok"></i> Select</a></li> </ul> </div> </div> @stop
Конечно, если вы хотите обеспечить своевременное обновление цен, то нужно использовать Recurly API и заполнять эти данные в шаблоне автоматически.
Теперь добавьте следующие строки в css/style.css:
.pricing-table .plan { background-color: #f3f3f3; text-align: center; } .plan:hover { background-color: #fff; } .plan { color: #fff; background-color: #5e5f59; padding: 20px; } .plan-name-bronze { background-color: #665D1E; color: #fff; padding: 20px; } .plan-name-silver { background-color: #C0C0C0; color: #fff; padding: 20px; } .plan-name-gold { background-color: #FFD700; color: #fff; padding: 20px; } .pricing-table-bronze { background-color: #f89406; color: #fff; padding: 20px; } .pricing-table .plan .plan-name span { font-size: 20px; } .pricing-table .plan ul { list-style: none; margin: 0; } .pricing-table .plan ul li.plan-feature { border-top: 1px solid #c5c8c0; padding: 15px 10px; } .pricing-three-column { margin: 0 auto; width: 80%; } .pricing-variable-height .plan { display: inline-block; float: none; margin-left: 2%; vertical-align: bottom; zoom:1; *display:inline; } .plan-mouseover .plan-name { background-color: #4e9a06 !important; } .btn-plan-select { font-size: 18px; padding: 8px 25px; }
И наконец создадим маршрут в app/routes.php
Route::get('/signup', function() { return View::make('home/signup'); });
Прием платежей
Вот мы и добрались до пункта приема платежей, а именно страница регистрации — оплата.
Во первых, давайте изменим user/register POST обратного вызова(callback). Вместо перенаправления на домашнюю страницу, мы будем перемещать пользователя на страницу оплаты. Замените эти строки:
return Redirect::to('/')->with( 'success', 'Welcome to the site, . Auth::user()->name . '!' );
на эти:
Session::put('register_user', $user); return Redirect::to('/user/register/payment');
Нам необходимо расширить макет по умолчанию так, что мы сможем вставлять JavaScript код в футер (низ). Добавьте следующую строку после последнего тега сценария:
@yield('scripts')
Теперь создадим новый маршрут:
Route::get('/user/register/payment', function() { Recurly_js::$privateKey = Config::get('recurly.private_key'); $plan = 'bronze'; // todo: get this from vars $user = Session::get('register_user'); $signature = Recurly_js::sign(array( 'account' => array( 'account_code' => 'user_' . $user->id ), 'subscription' => array( 'plan_code' => $plan, 'currency' => Config::get('recurly.default_currency') ) )); return View::make('user/register')->with(array( 'plan' => $plan, 'subdomain' => Config::get('recurly.subdomain'), 'currency' => Config::get('recurly.default_currency'), 'signature' => $signature )); });
Несколько замечаний по этому коду:
- Мы должный установить секретный ключ в классе Recurly_js, который мы будем принимать из файла конфигурации созданного ранее.
- Данные на подписку (план) мы должны получать из предыдущего этапа, созданного в регистрации. Этот кусок оставлен как самостоятельное упражнение
- Нам нужно создать сигнатуру (подпись) для Recurly.js, используя несколько частей информации, в их числе идентификатор пользователя, который мы создаем связывая класс (пользователя) и его ID
- Эта подпись передается на ряду с другой информацией в данном представлении
Страница оплаты состоит из двух частей, первая часть — простой HTML:
@extends('layouts.default') @section('content') <div id="recurly-subscribe"> </div> @stop
Recurly.js внедряет свой клиентский сгенерированный код формы оплаты в данный div.
Далее, мы добавим JavaScript к секции, которая получает вывод внизу шаблона макета:
@section('scripts') <script> Recurly.config({ subdomain: '{{ $subdomain }}', currency: '{{ $currency }}' }); Recurly.buildSubscriptionForm({ target: '#recurly-subscribe', // Signature must be generated server-side with a utility // method provided in client libraries. signature: '{{ $signature }}', successURL: '/user/register/confirm', planCode: '{{ $plan }}', distinguishContactFromBillingInfo: true, collectCompany: false, termsOfServiceURL: 'http://www.example.com/terms', acceptPaypal: true, acceptedCards: ['mastercard', 'discover', 'american_express', 'visa'], account: { firstName: 'Joe', lastName: 'User', email: 'test@example.net', phone: '555-555-5555' }, billingInfo: { firstName: 'Joe', lastName: 'User', address1: '123 somestreet', address2: '45', city: 'San Francisco', zip: '94107', state: 'CA', country: 'US', cardNumber: '4111-1111-1111-1111', CVV: '123' } }); </script> @stop
Здесь происходит волшебство — Recurly строит форму оплаты и выводит его в div c id #recurly-subscribe, которая требует часть информации, мы пришли к виду, который требует генерируемые подписи.
Затем, обратный вызов, который Recurly возвращает после успешной отправки формы, которая определяется в successURL следующими параметрами:
Route::post('/user/register/confirm', function() { $recurly_token = Input::get('recurly_token'); Recurly_js::$privateKey = Config::get('recurly.private_key'); $result = Recurly_js::fetch($recurly_token); var_dump($result); });
И снова мы инициализируем Recurly.js с секретным ключем из конфигурации, и используем его для извлечения объекта, представленного токеном, который Recurly посылает в качестве переменной POST (recurly_token). Это будет экземпляром Recurly_Subscription, из которого можно извлечь различную информацию. Я вывожу это с помощью var_dump(), что бы взглянуть на данные.
Для начала, давайте получим код плана, что бы узнать на что подписался пользователь:
$plan_code = $result->plan->plan_code;
Теперь, нужно найти соответствующую роль, заметьте — мы дали им имена “bronze”, “silver” и “gold”.
$role = Role::where('name', '=', $plan_code)->first();
Затем получим пользователя из сессии (а затем удалим его из сессии):
$user = Session::get('register_user'); Session::forget('register_user');
Далее, мы предоставляем роль для соответствующего нового пользователя:
$user->roles()->attach($role);
Затем, мы должны удалить отложенную роль:
$role_pending = $role_pending = Role::where('name', '=', 'pending')->first(); DB::table('role_user')->where('user_id', '=', $user->id)->where('role_id', '=', $role_pending->id)->delete();
Теперь, мы дополнили процесс регистрации приемом платежей, созданием подписок, а так же применять роли для новых учетных записей на основе выбранного пользователем плана.
Страница управления учетными записями
Давайте создадим простую страницу, с которой пользователи смогут управлять своим счетом.
Очевидно, это будет требовать того, чтобы пользователь вошел в систему, поэтому мы должны применить аутентификационный фильтр.
Вместо того, чтобы указывать этот фильтр для каждой защищенной страницы, мы можем поставить все соответствующие маршруты в группу, вот так:
Route::group(array('before' => 'auth'), function() { Route::get('/user/account', function() { // User must be logged in }); Route::get('user/account/billing', function() { // User must be logged in }); });
Вызов страницы учетной записи прост:
Route::get('/user/account', function() { return View::make('user/account/index'); });
Теперь адрес вида app/views/user/account/index.blade.php:
@extends('layouts.default') @section('content') <h1>Your Account</h1> <ul> <li><a href="/user/account/edit">Edit your account information</a></li> <li><a href="/user/account/plan">Update your subscription plan</a></li> <li><a href="/user/account/billing">Update your Billing information</a></li> </ul> @stop
Начнем с информационного обновления биллинговой страницы. Конечно, мы не храним платежную информацию людей, так как на страницу оплаты, Recurly будет создать и заполнять форму для вас, объявляя (POSTing) новую информацию к Recurly без него когда-нибудь недалеко от вашего веб-приложения.
Route::get('user/account/billing', function() { Recurly_js::$privateKey = Config::get('recurly.private_key'); $account_code = 'user_' . Auth::user()->id; $signature = Recurly_js::sign( array('account' => array('account_code' => $account_code)) ); return View::make('user/account/billing')->with(array( 'subdomain' => Config::get('recurly.subdomain'), 'currency' => Config::get('recurly.default_currency'), 'account_code' => $account_code, 'signature' => $signature )); });
Это очень похоже на страницу оплаты в том плане, что мы инициализируем библиотеки Recurly.js, создавая подписи (хотя и с использованием различной информации) и, проходя через несколько параметров в представление.
Путь app/views/user/account/billing.blade.php
следует в значительной степени той же схеме, на страницу оплаты:
@extends('layouts.default') @section('content') <div id="recurly-billing"> </div> @stop @section('scripts') <script> Recurly.config({ subdomain: '{{ $subdomain }}', currency: '{{ $currency }}' }); Recurly.buildBillingInfoUpdateForm({ target: '#recurly-billing', successURL: '/user/account/billing/confirm', accountCode: '{{ $account_code }}', signature: '{{ $signature }}' }); </script> @stop
Наконец, очень простой обратный вызов, когда пользователь заполнил информацию об оплате:
Route::post('user/account/billing/confirm', function() { return Redirect::to('/user/account')->with('success', 'Your billing information has been updated.'); });
И вот оно! пользователи могу обновить свою платежную информацию!
Я не реализовал редактирование учетной записи. Это довольно просто, и пусть это останется упражнением для вас.
Push-уведомления
В дополнение к возможностям для запроса API Recurly, сервис «ping» приложение с уведомлением, когда происходит какое-либо событие.
Эти уведомления не следует путать с мобильного разнообразием, однако — они совершенно разные.
По существу служба отправляет POST-запрос к URI, и посылает XML документ как тело запроса. Вы можете использовать библиотеки Recurly, что бы извлечь необходимую информацию, и действовать соответственно. Эти уведомления подробно описаны в документации Recurly.
Давайте определим нашу функцию обратного вызова, когда было получено уведомление:
Route::post('recurly', function(){ $xml = file_get_contents ("php://input"); $notification = new Recurly_PushNotification($xml); switch ($notification->type) { // ... process notification } });
Вы, наверное, поняли, что, как только кто-то подписался и заплатил за услугу, он остается неопределенным подписчиком, и не понятно, продолжается ли их подписка или нет. Так, наибольший интерес представляет уведомление об отмене подписки. Мы можем использовать уведомление от Recurly, что бы определить неактивные подписки и отзывать соответствующие роли. Например:
switch ($notification->type) { case 'canceled_subscription_notification': // get the account code $account_code = $notification->account->account_code; // extract the user ID (account_code format is user_ID) $user_id = intval(substr($account_code, (strpos($account_code, '_')+1))); // find the user in question $user = User::find($user_id); // get the plan code $plan_code = $notification->subscription->plan->plan_code; // find the corresponding role... $role = Role::where('name', '=', $plan_code)->first(); // ...and revoke it DB::table('role_user')->where('user_id', '=', $user->id)->where('role_id', '=', $role)->delete(); break; // ... process notification }
Есть целый ряд других вещей, которые вы могли бы сделать, в зависимости от типа уведомления.
Вы можете использовать уведомления новый, обновленный, отменен, и т.д., чтобы создать историю подписки, отслеживать количество членов, и анализировать отказы. Вы также можете использовать уведомления о транзакции — будь то положительные (платежи) или отрицательные (возвраты) — отслеживать фактический и ожидаемый доход.
На этом оригинальная статья заканчивается. Спасибо всем, кто прочитал ее. Местами, я не понимал, что хочет сказать автор, вы поймете это при прочтении. Если вам будет интересен результат, то я выложу на гитхаб то, что получилось у меня (Сейчас, к сожалению не могу выложить — нет времени доделать практику по второй части). Спасибо за уделенное время!
ссылка на оригинал статьи http://habrahabr.ru/post/221815/
Добавить комментарий