mltpss/php-sdk

Wednesday, July 18, 2018
by sqweb
Repository
1 Watchers
1 Stars
5 Installations

PHP
0 Dependents
0 Suggesters
0 Forks
0 Open issues
33 Versions
0 % Grown

The README.md

Multipass - PHP SDK

, _(*1)

Requirements

This SDK has been tested with PHP 5.5 and greater., _(*2)

We are unable to provide official support for earlier versions. For more information about end of life PHP branches, see this page., _(*3)

Install

This package is intended for custom PHP websites and advanced integrations., _(*4)

If you're using WordPress, we've made it easy for you. Download the SQweb plugin directly from WordPress.org, or check out the source., _(*5)

Recommended : Composer + dotenv

In your project root, execute composer require mltpss/php-sdk., _(*6)
Create a .env file at the root of your project, or edit it if you already have one., _(*7)
In .env, paste the following configuration:, _(*8)
```
SQW_ID_SITE=YOUR_WEBSITE_ID
SQW_SITENAME=YOUR_WEBSITE_NAME
SQW_LANG=en_US
```
Change SQW_ID_SITE with your website ID and SQW_SITENAME with the name to show on the large Multipass button., _(*9)

For additional settings, see "Options" below., _(*10)

Composer + Manual Configuration

In your project root, execute composer require mltpss/php-sdk.
Create a new SQweb object passing in its configuration through the constructor. SQW_ID_SITE and SQW_SITENAME must be specified., _(*11)
```
require_once('vendor/autoload.php');
$sqweb = new \SQweb\SQweb(['SQW_ID_SITE' => 1234, 'SQW_SITENAME' => 'SQweb']);
```

For additional settings, see "Options" below., _(*12)

Manually

Download the latest release of the SDK and unzip it in a folder named sqweb in your project root.
Create a file named sqweb.config at the root of your project. This file should be one level up from the sqweb folder you just created, i.e. :, _(*13)
```
|–- sqweb/
|   |-- src/
|   |   |-- init.php
|   |   |-- SQweb.php
|-- sqweb.config
```
In sqweb.config, paste the following configuration:, _(*14)
```
SQW_ID_SITE=YOUR_WEBSITE_ID
SQW_SITENAME=YOUR_WEBSITE_NAME
SQW_LANG=en_US
```
Change SQW_ID_SITE with your website ID and SQW_SITENAME with the name to show on the large Multipass button., _(*15)

For additional settings, see "Options" below., _(*16)

Usage

1. Initializing the SDK

First, you have to initialise SQweb variable on the pages where you wish to use it., _(*17)

If you used composer:, _(*18)

$sqweb = new SQweb\SQweb;

If you installed manually:, _(*19)

include_once "whereYouInstalled/src/init.php";

2. Tagging your pages

Then, you need to add our JavaScript tag to your pages. This function will do it for you, and should be inserted before the closing </body> tag in your HTML., _(*20)

$sqweb->script();

Make sure it is present on all your pages. Most likely you'll just have to add it to your template., _(*21)

If you previously had a SQweb JavaScript tag, make sure to remove it to avoid any conflicts., _(*22)

3.a Checking the credits of your subscribers

Check if the user has credits, so that you can disable ads and/or unlock premium content., _(*23)

if ($sqweb->checkCredits() > 0) {
    // CONTENT
} else {
    // ADS
}

3.b Retrieving the user's email

If he wants it, the user can share his email with you, to retrieve it, check if the cookie named mltpss_e exists. Inside will be a base64 encoded string you need to retrieve and decode on your side., _(*24)

for instance:, _(*25)

if ($_COOKIE['mltpss_e']) {
    $email = base64_decode($_COOKIE['mltpss_e']);
}

This piece of code will store the email in the $email variable if the cookie is set., _(*26)

4.a Showing the Multipass button

Use this code to display the Multipass button on your pages:, _(*27)

$sqweb->button();

We have 3 additionals sizes for the button, to use it, pass a string to the function:, _(*28)

$sqweb->button('tiny');
$sqweb->button('slim');
$sqweb->button('large');

We also have another type of button, the free button, which offer to share the user's email with you. To display it, use this function:, _(*29)

$sqweb->button('free');

Example Buttons , _(*30)

4.b Customizing the Multipass button

If you want to customize our different type of button, put the following in your config file (.env if you used composer and dotenv or sqweb.config if you did not) of in the sqweb config file. For instance: SQW_LOGIN=Hello world Will show Hello world instead of Premium with Multipass on the regular button for logged out visitors., _(*31)

Button Model	Logged in	Logged out
Tiny	`SQW_CONNECTED_TINY`	`SQW_LOGIN_TINY`
Regular	`SQW_CONNECTED`	`SQW_LOGIN`
Large - before black dot	N / A	`SQW_BTN_UNLIMITED`
Large - after black dot	N / A	`SQW_BTN_NOADS`
Large connected	`SQW_CONNECTED_S`	N / A

5. More functions

Display a support div for your users

/**
 * Display a "Support us" message.
 */

function supportBlock() {   }
``

For instance:

```php
$sqweb = new SQweb;

$sqweb->supportBlock();

Will display the block., _(*32)

Display a locking div for your users

/**
 * Display a locking block.
 */

function lockingBlock() {   }
``

For instance:

```php
$sqweb = new SQweb;

$sqweb->lockingBlock();

We recommend that you use it with our other blocking function :, _(*33)

if ($sqweb->waitToDisplay('15/09/16', 'd/m/y', 2)) {
    // The content here will appear 2 days after the publication date for non paying users.
} else {
    // Here you can put content that free users will see until the content above is available for all.
    $sqweb->lockingBlock();
}

Display only a part of your content to non premium users

/**
 * Put opacity to your text
 * Returns text  with opacity style.
 * @param $text  Text you want to limit.
 * @param int $percent Percent of your text you want to show.
 * @return string
 */

function transparent($text, $percent = 100) { ... }

For instance:, _(*34)

echo $sqweb->transparent('one two three four', 50);

Free users will see:, _(*35)

one two

Display your content later for non paying users

/*
 * @param string $date  When to publish the content on your site. It must be an ISO format(YYYY-MM-DD).
 * @param int $wait  Number of days you want to wait before showing this content to free users.
 */

function waitToDisplay($date, $wait = 0) { ... }

Example:, _(*36)

if ($sqweb->waitToDisplay('15/09/16', 'd/m/y', 2)) {
    // The content here will appear 2 days after the publication date for non paying users.
} else {
    // Here you can put content that free users will see until the content above is available for all.
}

Limit the number of articles free users can read per day

For instance, if I want to display only 5 articles to free users:, _(*37)

if ($sqweb->limitArticle(5) === true) {
    echo "This is my article";
} else {
    echo "Sorry, you reached the limit of pages you can see today, come back tomorrow or subscribe to Multipass to get unlimited articles !";
}

Options

Unless otherwise noted, these options default to false. You can set them in your configuration., _(*38)

Option	Description
`SQW_DEBUG`	Output various messages to the browser console while the plugin executes.
`SQW_DWIDE`	Set to `false` to only enable SQweb on the current domain. Defaults to `true`.
`SQW_LANG`	We support these locales: `en_US`, `en_GB` and `fr_FR`.
`SQW_AUTOLOGIN`	Enable or disable our autologin feature. Defaults to `true`.

Known Issues

If you change the value of SQW_DWIDE after initial deployment, your users will have to log in again since their auth cookie will no longer be valid., _(*39)

Troubleshooting

I am not seeing the Multipass button

Please make sure you have properly initialized the SDK and tagged your pages. Mind the position of the include and tag., _(*40)

The authentication requires cookies, which require fully qualified domain names. If you are testing on localhost or an IP, the authentication will succeed but won't be able to save a cookie in your browser., _(*41)

Contributing

We welcome contributions and improvements., _(*42)

Coding Style

All PHP code must conform to the PSR2 Standard., _(*43)

Builds and Releases

See RELEASE.md., _(*44)

Bugs and Security Vulnerabilities

If you encounter any bug or unexpected behavior, you can either report it on Github using the bug tracker, or via email at hello@sqweb.com. We will be in touch as soon as possible., _(*45)

If you discover a security vulnerability within SQweb or this plugin, please send an e-mail to hello@sqweb.com. All security vulnerabilities will be promptly addressed., _(*46)

License

This program is free software ; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation ; either version 3 of the License, or any later version., _(*48)

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY ; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details, _(*49)

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/., _(*50)

The Versions

18/07 2018

dev-master

9999999-dev

library php-sdk

mltpss/php-sdk

The README.md

Multipass - PHP SDK

Requirements

Install

Recommended : Composer + dotenv

Composer + Manual Configuration

Manually

Usage

1. Initializing the SDK

2. Tagging your pages

3.a Checking the credits of your subscribers

3.b Retrieving the user's email

4.a Showing the Multipass button

4.b Customizing the Multipass button

5. More functions

Display a support div for your users

Display a locking div for your users

Display only a part of your content to non premium users

Display your content later for non paying users

Limit the number of articles free users can read per day

Options

Known Issues

Troubleshooting

I am not seeing the Multipass button

I can see the Multipass button, but I cannot login

Contributing

Coding Style

Builds and Releases

Bugs and Security Vulnerabilities

License

The Versions

dev-master

The Requires

The Development Requires

by Bastien Botella

by Pierre Lavaux

by Mathieu Darrigade

by Matthieu Borde

by Nicolas Verdonck

by David Goodwin

v1.7.7

The Requires

The Development Requires

by Bastien Botella

by Pierre Lavaux

by Mathieu Darrigade

by Matthieu Borde

by Nicolas Verdonck

by David Goodwin

v1.7.6

The Requires

The Development Requires

by Bastien Botella

by Pierre Lavaux

by Mathieu Darrigade

by Matthieu Borde

by Nicolas Verdonck

by David Goodwin

v1.7.4

The Requires

The Development Requires

by Bastien Botella

by Pierre Lavaux

by Mathieu Darrigade

by Matthieu Borde

by Nicolas Verdonck

by David Goodwin

v1.7.5

The Requires

The Development Requires

by Bastien Botella

by Pierre Lavaux

by Mathieu Darrigade

by Matthieu Borde

by Nicolas Verdonck

by David Goodwin

v1.7.3

The Requires