NAV Navbar
Logo
php

معرفی

به صفحه مستندات وب سرویس ژاکِت خوش آمدید.

وب سرویس ژاکِت قابلیت ویژه‌ای است که در اختیار فروشندگان ژاکِت قرار گرفته است. با استفاده از این وب سرویس قادر خواهید بود برای محصولات خود در ژاکِت لایسنس تعریف کرده و از کپی شدن آن‌ها و نصب‌های متعدد بر روی وبسایت‌های مختلف جلوگیری نمایید.

برای استفاده از این وب‌سرویس ابتدا کلاس PHP وب سرویس را از گیت‌هاب دانلود نمایید و با استفاده از متدهایی که در ادامه معرفی شده اند لایسنس را در افزونه یا قالب وردپرسی خود فعال نمایید.

نصب لایسنس

برای نصب و فعال سازی لایسنس از متد زیر استفاده می‌کنیم:

<?php
    require 'zhaket-api.class.php';

    $license_token = 'LICENSE_TOKEN'; // Your license token
    $produc_token = 'PRODUCT_TOKEN'; // Your product token

    /*
        @param1 : license_token
        @param2 : product_token
        replace it with your own license token and product token :)
    */
    $result = Zhaket_License::install($license_token, $produc_token);

    if ($result->status=='successful') {
        echo $result->message; // License installed successful
    } else {
        // License not installed / show message
        if (!is_object($result->message)) {// License is Invalid
            echo $result->message;
        } else {
            foreach ($result->message as $message) {
                foreach ($message as $msg) {
                    echo $msg.'<br>';
                }
            }
        }
    }
?>

توجه داشته باشید که در کدهای بالا حتما مقادیر LICENSE_TOKEN و PRODUCT_TOKEN را با توکن‌های محصول و لایسنس خود جایگزین کنید.

عملیات نصب لایسنس باید پس از نصب قالب یا افزونه توسط کاربر به صورت خود کار انجام شود. برای این کار توصیه می کنیم یک قسمت به داشبورد وردپرس و تنظیمات افزونه یا قالب خود اضافه کنید و کد لایسنس را از کاربر دریافت کنید.

پس از دریافت کد لایسنس با استفاده از متد install اقدام به فعال‌سازی لایسنس نمایید.

توجه داشته باشید که هر لایسنس تنها یک بار مجاز به نصب بوده و در صورتی که کاربری مایل به نصب محصول شما بر روی چند سایت باشد باید برای هر وبسایت به صورت مجزا لایسنس تهیه کند.

از قسمت سمت راست می‌توانید نمونه کدی که با متد install نوشته شده است را مشاهده نمایید.

بدیهی است که کد نمونه به ساده ترین شکل ممکن نوشته شده است و برای هماهنگی کامل با محصول شما می‌بایست متناسب با ساختار محصول شما و چگونگی فرآیند فعال‌سازی در آن، کد نمونه تغییر کند.

توصیه می‌کنیم در صورت موفق بودن نصب لایسنس، به منظور بررسی وضعیت لایسنس در آینده حتما توکن لایسنس را داخل دیتابیس کاربر ذخیره نمایید.

بررسی وضعیت لایسنس

برای بررسی وضعیت لایسنس از نمونه کد زیر استفاده نمایید:

<?php
    require 'zhaket-api.class.php';

    $license_token = 'LICENSE_TOKEN'; // Your license token

    /*
     * @param : license token
     * replace it with your own license token :)
     */
    $result = Zhaket_License::isValid($license_token);

    if ($result->status=='successful') {
        echo $result->message; // License is valid
    } else {
        // License not valid / show message
        if (!is_object($result->message)) { // License is Invalid
            echo $result->message;
        } else {
            foreach ($result->message as $message) {
                foreach ($message as $msg) {
                    echo $msg.'<br>';
                }
            }
        }
    }
?>

در کد بالا باید به جای LICENSE_TOKEN توکن لایسنس کاربر را وارد نمایید.

متد isValid به شما این قابلیت را خواهد داد تا وضعیت لایسنس فعال شده بر روی محصول خود را مرتبا بررسی نمایید.

برای این منظور کافی است متد isValid را در زمان‌های مورد نظر بررسی کنید و در صورت فعال بودن لایسنس عملیات‌های خود را انجام دهید.

توصیه می‌کنیم وضعیت لایسنس خود را هر 24 ساعت از طریق وب سرویس بررسی کرده و نتیجه را داخل دیتابیس ذخیره کنید و در بقیه مواردی که لازم به بررسی وضعیت لایسنس هستید حتما وضعیت را از دیتابیس بخوانید.

php