آموزش کدنویسی ماژول Whmcs

آموزش کدنویسی ماژول Whmcs

در این قسمت از آموزش های کاربردی طرح کار با آموزش کدنویسی ماژول whmcs برای این اسکریپت قدرتمند در خدمت شما همراهان عزیز هستیم.

لازمه فراگیری این آموزش زبان PHP و تا حدودی HTML,CSS میباشد، لذا قبل از فراگیری این آموزش باید به زبان ذکر شده تا حد کافی مسلط باشید.

موارد آموزشی در این پکیج (آموزش کدنویسی ماژول Whmcs) به شرح زیر میباشد :

• آشنایی با محیط کدنویسی
• معرفی متدهای ماژول نویسی WHMCS
• فایل بندی پروژه کدنویسی
• نحوه شروع کدنویسی با معرفی دقیق آنها
• نحوه لایسنس گذاری روی ماژول
• نحوه پیاده سازی ماژول روی اسکریپت
• نحوه استفاده از زبان های مختلف در بیس در ماژول
• کدنویسی بخش فعال و غیرفعال سازی ماژول از مدیریت
• نحوه ارتباط ماژول به دیتابیس و ساخت و حذف دیتابیس
• نحوه کدنویسی بخش مدیریت برای ماژول
• نحوه کدنویسی هوک های مربوطه
• و …

---

جلسه دوم آموزش

آشنایی با محیط کدنویسی :

برای شروع کدنویسی محیط های زیادی وجود داره. بنده به شخصه از برنامه بسیار ساده و درعین حال کاربردی ++Notepad استفاده میکنم. ولی خب از آنجایی که همچین برنامه هایی معمولا مخاطب های خاص خود رو دارند ممکنه شما با این برنامه راخت نباشید که من در زیر چند نمونه برنامه برای شروع کدنویسی معرفی میکنم :

1. دانلود نرم افزار PhpStorm
2. دانلود نرم افزار WebStorm

برنامه های ذکر شده در بالا هم برنامه های خوبی در زمینه کدنویسی میباشند.

---

معرفی متدهای ماژول نویسی WHMCS

توی این قسمت از آموزش من چندین نمونه از کدهایی که لازمه کدنویسی ماژول میباشد رو معرفی میکنم :

• config : کار این کد معرفی تنظیمات ماژول میباشد
• activate : با استفاده از این کد ما میاییم ماژولی که کدنویسی کردیم رو با استفاده از گزینه فعال سازی از بخش تنظیمات فعال میکنیم
• deactivate : با استفاده از این کد ما میاییم ماژولی که کدنویسی کردیم رو باستفاده از گزینه غیرفعال سازی از بخش تنظیمات غیرفعال میکنیم
• output : این کد نیز مربوط به خروجی ماژول میباشد که اگر بخواییم بخش تنظیمات برای ماژول رو کدنویسی کنیم باید داخل فانکشن این تابع کدنویسی کنیم.

خب تا اینجای کار فعلا با همین متدها میتونیم ماژول رو کدنویسی کنیم. پس من زیاد شلوغ نمیکنم بحث رو تا قابل درک باشه.

---

فایل بندی پروژه

اصولا برای کدنویسی یک ماژول با توجه به نوع و حجم ماژول تعداد فایل ها نیز متفاوت هست ولی بیس کدنویسی بدین صورت هست که ما ابتدا باید یک پوشه با نام معین برای ماژول خود بسازیم و سپس یک فایل با پسوند php با همان نام پوشه ایجاد کنیم تا کدنویسی رو داخلش شروع کنیم. بعنوان مثال من میخوام نام پوشه ماژول به نام tarhmodule باشه پس باید داخل این پوشه یک فایل با پسوند php با نام tarhmodule.php بسازم که داخل این فایل شروع به کدنویسی کنم. حال اگر ماژول ما دارای هوک هم هست باید یک فایل دیگر با نام Hooks.php بسازیم.

---

شروع کدنویسی

خب بریم سراغ کار اصلیمون :

من کار رو از همین ابتدای کار با مثال شروع میکنم.

ما میخواییم یک ماژول بنویسیم که در تنظیمات WHMCS قابل نمایش و فعال سازی باشه و دارای قسمت تنظیماتی باشه که داخل یک فیلد هست که نام ماژول رو بهش میدیم و ذخیره میکنیم. من اسم ماژول رو میزارم : tkfield ، خب پس یک پوشه با همین نام میسازیم و داخل پوشه یک فایل با نام tkfield.php ایجاد میکنیم.

همانطور که در بالا عرض کردم با استفاده از فانکشن config کار رو شروع میکنیم تا به معرفی ماژول بپردازیم :

این فانکش شامل موارد زیر میباشد :

1. name : نام ماژول
2. description : معرفی ماژول
3. version : نسخه ماژول
4. author : طراح ماژول
5. language : زبان ماژول

همه موارد بالا داخل آرایه کدنویسی میشن که بصورت زیر میباشد :

function tkfield_config() {
    $configarray = array(
    "name" => "ماژول من",
    "description" => "این یک ماژول ساده میباشد",
    "version" => "1.0",
    "author" => "طرح کار",
    "language" => "Persian",
);
    return $configarray;
}

توجه : تمام فانکشن های نوشته شده باید با نام پوشه شروع شوند

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

---

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

پس کدهای ما بصورت زیر میشود :

function tkfield_activate() {
    $query = "CREATE TABLE `tkfield` (	
    `id` INT(10) NOT NULL AUTO_INCREMENT PRIMARY KEY,
    `field` TEXT CHARACTER SET utf8 NOT NULL
    );";
    mysqli_set_charset($query, 'utf8');
    $result = full_query($query);
}

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