[spadana2004]

این مثال مراحل توسعه افزونه ساده "سلام دنیا" (  Hello World ) را در چارچوب نرم افزار ویتایگر 6 نشان می دهد.
پیش نیازها

•  نرم افزار ویتایگر 6 نصب شده بر روی سرور شما (از این نسخه برای توسعه استفاده می کنید)
  
•  PHP CLI (استفاده از خط فرمان PHP) برای فراخوانی از خط فرمان یا ترمینال نصب شده 
  
•   بررسی دقیق اسناد توسعه ماژول : توسعه افزونه برای ویتایگر
  

اصطلاحات

• <vtigercrm> - دایرکتوری روت یا مسیر روت که نرم افزار ویتایگر 6  در آن نصب شده است.
  
• http://<vtigercrm>  - دسترسی وب به ویتایگر
  

نکته:
شما می توانید فایل زیپ ماژول را از ضمیمه دانلود کنید.


مرحله 1: ایجاد فایل ها
یک پوشه برای پروژه ایجاد کنید (مثلابر روی دسکتاپ) و فایل های زیر را در آن ایجاد کنید.

[فقط اعضای انجمن قادر به مشاهده محتوای این قسمت می باشند برای ثبت نام کلیک نمایید]
 
مرحله دوم: manifest.xml
manifest.xml را ویرایش و اطلاعات پایه مورد نیاز برای دریافت افزونه نصب شده در نرم افزار ویتایگر را تکمیل نمایید.
 
[فقط اعضای انجمن قادر به مشاهده محتوای این قسمت می باشند برای ثبت نام کلیک نمایید]
Type:نوع ماژول را مشخص می کند که در آینده به تفضیل در مورد آن توضیح میدیم
Name: نام ماژول و پوشه نصب آن را مشخص می کند
Label: نامی که برای ماژول در سیستم نمایش داده می شود
Parent: نام بخشی در منو  که ماژول در آن نمایش داده خواهد شد
Version: نسخه ماژول تولید شده توسط شما را نمایش می دهد
در بخش وابستگی ها 
vtiger_version:  حداقل نسخه ویتایگر برای نصب ماژول
vtiger_max_version: حداکثر نسخه ای که ماژول می تواند روی آن نصب شود 6.* به معنی همه نسخه های ورژن 6 است


مرحله 3: کلاس ماژول
فایل کلاس ماژول را به روز رسانی کنید (modules/HelloWorld/HelloWorld.php ).

[فقط اعضای انجمن قادر به مشاهده محتوای این قسمت می باشند برای ثبت نام کلیک نمایید]

 
نکته:
پیشنهاد می کنیم که این فایل را داشته باشید- حتی اگر خالی هم باشد، باز هم در آینده مفید می باشد.

مرحله 4: کلاس View
modules/HelloWorld/views/List.php را ویرایش کنید
 
[فقط اعضای انجمن قادر به مشاهده محتوای این قسمت می باشند برای ثبت نام کلیک نمایید]


نکته
نمایه پیش فرض برای این صفحه در ویتایگر نمایه لیست List View تنظیم شده است. شما می توانید آن را با نمایه های دیگر در ویتایگر جایگزین کنید

مرحله 5: قالب View
templates/List.tpl را ویرایش نمایید و کد HTML مورد نظر خود را در آن وارد نمایید. دقت نمایید قالب وارد شده بهتر است با bootstrap سازگار باشد
 
[فقط اعضای انجمن قادر به مشاهده محتوای این قسمت می باشند برای ثبت نام کلیک نمایید]


مرحله 6:  بسته زبان i18n

فایل های languages/fa_ir/HelloWorld.php و languages/en_us/HelloWorld.php را  ایجاد و ویرایش نمایید

 languages/fa_ir/HelloWorld.php 

[فقط اعضای انجمن قادر به مشاهده محتوای این قسمت می باشند برای ثبت نام کلیک نمایید]

 languages/en_us/HelloWorld.php

[فقط اعضای انجمن قادر به مشاهده محتوای این قسمت می باشند برای ثبت نام کلیک نمایید]

نکته
تمام مقادیر ثابت رشته ای مورد استفاده در ماژول را ب اضافه کنید- برای پشتیبانی i18n لازم می باشد.

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

[فقط اعضای انجمن قادر به مشاهده محتوای این قسمت می باشند برای ثبت نام کلیک نمایید]

این ساختار مربوط به ایجاد بسته نصبی می باشد

مرحله 8: نصب در ویتایگر
شما می توانید از طریق رابط کاربری مدیر ماژول آن را نصب کنید.
نکته
ورود از طریق دستورات CLI در زیر نشان داده شده است.

[فقط اعضای انجمن قادر به مشاهده محتوای این قسمت می باشند برای ثبت نام کلیک نمایید]








ImportHelloWorld.php باید از vtlib API برای وارد کردن بسته استفاده کند. نمونه کد پیاده سازی آن در زیر آورده شده است

[فقط اعضای انجمن قادر به مشاهده محتوای این قسمت می باشند برای ثبت نام کلیک نمایید]



 
این ماژول اکنون نصب شده و آماده می باشد، شما می توانید آن را از بخش همه -> ابزارها پیدا کنید.

[spadana2004]

فایل HelloWorld را می توانید از پایین دریافت نمایید