Plugin usługi sms-dostep dla Joomla 2.5.x i 3.x.x

Plugin dla innych wersji Joomla

Plugin dla Joomli w wersji 2.5.x i 3.x.x. umożliwia publikowanie płatnych artykułów. Dodatek oferuje:

• wyznaczenie stref płatnego dostępu; każda jest płatna oddzielnie, opłacenie dostępu do danej strefy oznacza dostęp do wszystkich artykułów w tej strefie;
• określenie do trzech grup cenowych artykułów;
• ustalenie do trzech wariantów płatności w każdej grupie cenowej; warianty umożliwiają dostęp na czas zależny od kwoty dokonanej płatności.

Dodatek jest przygotowany w dwóch wersjach:

• wersja serwerowa (pobierz):
  • autoryzacja kodów SMS jest dokonywana po stronie serwera
  • do działania wymaga wyłączenia mechanizmów cache w joomli
  • przed opłaceniem dostępu do przeglądarki jest przesyłany tylko wstęp artykułu i formularz płatności SMS (ograniczony transfer)
• wersja kliencka (pobierz):
  • autoryzacja kodów SMS jest realizowana w przeglądarce klienta z wykorzystaniem JavaScript
  • współpracuje z cache joomli
  • do przeglądarki oprócz wstępu artykułu i formularza płatności jest przesyłana pełna treść artykułu w postaci zaszyfrowanej, która zostaje odszyfrowana i wyświetlona po wprowadzeniu prawidłowego kodu SMS

Instalacja

Aby uruchomić płatny dostęp do treści w serwisie opartym na Joomla 2.5.x lub 3.x.x, należy wykonać następujące czynności:

1. Po zalogowaniu do konta w systemie wysłać zgłoszenie uruchomienia nowego serwisu SMS, wskazując usługę płatnego dostępu i poczekać na przydzielenie parametrów usługi (prefiks i klucz prywatny).
2. Pobrać pakiet instalacyjny pluginu w wersji serwerowej lub klienckiej i zapisać go na dysku.
3. Zalogować się do panelu administracyjnego Joomla.
4. Wejść do managera rozszerzeń (Extension Manager).
5. W sekcji Upload Package File wskazać pobrany plik pakietu instalacyjnego i wybrać Upload File & Install.
6. Wejść do modułu zarządzania dodatkami (pluginami).
7. Wejść do konfiguracji komponentu Content - Atom.SMS - Płatny dostęp i wprowadzić parametry konfiguracyjne zgodnie z poniższym opisem konfiguracji.
8. Opublikować plugin korzystając z ikony w kolumnie Published.

Konfiguracja

Uwaga: aby plugin płatnego dostępu w wersji serwerowej SMS działał prawidłowo, witryna musi mieć wyłączone korzystanie z pamięci podręcznej:
Witryna/Konfiguracja/Schowek/Korzystaj z pamięci podręcznej: Nie
Jeśli korzystanie z pamięci podręcznej jest niezbędne, należy skorzystać z rozszerzenia do zarządzania pamięcią podręczną (np. Cache Control) i wyłączyć pamięć podręczną dla płatnych artykułów lub skorzystać z dodatku w wersji klienckiej.

Konfiguracja komponentu wymaga na wstępie określenia sposobu dokonywania płatności. Mamy możliwość zaklasyfikowania płatnych treści do trzech grup cenowych. Dostęp do każdej z grup może mieć inne stawki (kwoty SMSów). Ponadto w każdej z grup cenowych istnieje możliwość określenia wariantów płatności. Warianty umożliwiają uzyskanie przez użytkownika dostępu do artykułu na różny czas w zależności od kwoty wysłanego SMSa. W każdym z wariantów podajemy stawkę SMS oraz czas, na jaki jest przyznawany dostęp.

Po ustaleniu strategii pobierania płatności wprowadzamy parametry konfiguracyjne:

• Prefiks SMS - przydzielony prefiks SMSa, można go odczytać w module Serwisy SMS
• Klucz prywatny - podobnie jak prefiks, jest to parametr przydzielony w czasie aktywacji usługi i możliwy do odczytania w tym samym miejscu co prefiks.
• Tryb - tryb testowy umożliwia przetestowanie działania pluginu i sprawdzenie dostępu do płatnych stref bez konieczności wysyłania SMSów. Gdy wszystkie testy wypadną pozytywnie, można przełączyć działanie w tryb produkcyjny.
• Kodowanie strony - kodowanie znaków używane na Twojej stronie Joomla. Niewłaściwe ustalenie tego parametru będzie skutkowało nieprawidłowym wyświetlaniem formularza płatności SMS (tzw. "krzaczki").
• Płatne strefy - umożliwiają automatyczne lub ręczne ustalenie stref płatnych:
  • sekcje - każda sekcja jest oddzielną strefą; pojedyncza płatność daje dostęp do wszystkich artykułów z tej samej sekcji;
  • kategorie - każda kategoria jest oddzielną strefą; pojedyncza płatność daje dostęp do wszystkich artykułów z tej samej kategorii;
  • artykuły - każdy artykuł jest osobną strefą; dostęp do każdego artykułu jest oddzielnie płatny;
  • ręcznie - administrator ma możliwość samodzielnego ustanawiania stref płatnych (parametr s opisany w instrukcji użytkowania).
• Kody ważne dla adresu IP - ustawienie tego parametru na tak powoduje, że kod zwrócony w SMSie będzie działał tylko z tego adresu IP komputera, na którym został wyświetlony formularz zamówienia SMS (użytkownik nie będzie mógł udostępnić kodu, ponieważ nie zadziała on na komputerze z innym adresem IP).
• Dostęp na czas i - za SMSa w cenie - przy pomocy tych parametrów określamy warianty cenowe dla wszystkich grup cenowych. Jeśli nie używamy różnych grup cenowych, wystarczy zdefiniować tylko warianty dla pierwszej grupy (grupa domyślna). Jeśli nie chcemy określać wariantów płatności, w nieużywanych wariantach w polu Dostęp na czas wybieramy opcję - brak -.
  Uwaga: kwoty SMSów możemy wybrać wyłącznie spośród skonfigurowanych i widocznych w module Serwisy SMS. Wybranie innych stawek spowoduje nieprawidłowe działanie płatności SMS.

Używanie komponentu

W celu ustalenia, że artykuł jest płatny używamy zdefiniowanego znacznika {sms-dostep}. Znacznik ten należy umieścić w dowolnym miejscu głównej treści artykułu (Main Text). Nie należy go używać we wstępie (Intro Text), ponieważ spowoduje to wyświetlenie formularza płatności SMS nawet wtedy gdy wyświetlany jest wstęp (np. informacja o artykule na głównej stronie). Aby podzielić artykuł na wstęp i część główną, w edytorze artykułu należy użyć przycisku Read More (w wersji angielskiej) znajdującego się pod oknem z treścią artykułu.
Składnia znacznika jest następująca:

Parametr g (grupa cenowa) oznacza grupę cenową, do której należy artykuł i może przyjąć wartości 1, 2 lub 3. Jeśli parametr nie zostanie określony, domyślnie przyjmowana jest wartość 1 (pierwsza grupa cenowa).

Parametr s (strefa) ma znaczenie tylko w przypadku, gdy w konfiguracji określimy strefy ustalane ręcznie. Wówczas Strefa powinna być znakiem liter i cyfr bez spacji i oznacza strefę płatnego dostępu. Wykupienie dostępu do artykułu daje użytkownikowi dostęp do wszystkich artykułów z tej samej strefy.

Przykłady

Cały serwis jest jedną strefą

Wysyłając SMSa użytkownik otrzymuje czasowy dostęp do całego serwisu.
Parametr Płatne strefy w konfiguracji należy ustawić na ręcznie a w głównej treści każdego płatnego artykułu należy wstawić znacznik {sms-dostep}.

Artykuły są w różnych cenach, każda grupa cenowa stanowi strefę

Artykuły mają różne ceny określone przez przynależność do jednej z trzech grup cenowych. Każda płatność za artykuł daje użytkownikowi dostęp do wszystkich artykułów w tej samej grupie cenowej.
Parametr Płatne strefy w konfiguracji należy ustawić na ręcznie a w głównej treści każdego płatnego artykułu należy wstawić znacznik {sms-dostep g1}, {sms-dostep g2}, {sms-dostep g3} w zależności od grupy cenowej artykułu.

Każda kategoria jest osobną strefą

Wykupienie dostępu do artykułu daje użytkownikowi dostęp do wszystkich artykułów z tej samej kategorii. Dostęp do artykułu z innej kategorii wymaga osobnego opłacenia.
Parametr Płatne strefy w konfiguracji należy ustawić na kategorie, a w głównej treści każdego płatnego artykułu należy wstawić znacznik {sms-dostep}.