من ویتایگر را روی هاست با سی پنل نصب کردم. زمانی که ماژول مدیریت ایمیل را باز می کنم و می خوام تنظیمات اتصال به اکانت جیمیل را انجام بدم صفحه توی لودینگ گیر می کنه و تا صفحه را رفرش نکنم اتفاق خاصی نمی افته. برای حل مشکل چه تنظیماتی باید انجام بدم
پیش از شروع به توضیحات لازم به توضیح است مختصری در مورد Third Party و Restful API توضیح دهم و سپس به ادامه آموزش در مورد اتصال ویتایگر به سایر سرویس ها بپردازم
آشنایی با مفهوم RESTful API
یکی از بخشهای لاینفک وب مدرن، ای پی آی ها، به کارگیری از آن ها، توسعه ی آنها و مهم از همه معماری RESTful API است که هر توسعهدهنده ی وب اپلیکیشنی، باید با ساز و کار آن آشنایی داشته باشد که در این آموزش قصد دارم نگاهی کلی به مفهوم رستفول ای پی آی داشته باشم.
REST مخفف واژگان Representational State Transfer است که از سال ۲۰۰۵ در وب شناخته شد که در ظاهر کمی گیجکننده به نظر می رسد، اما با کمی توضیح، میتوان این مفهوم در ظاهر پیچیده را رمزگشایی کرد!
اگر خیلی ساده بخواهم به این قضیه نگاه کنم، REST عبارت است از راه کارها و روشهایی که با استفاده از آنها میتوان به رد و بدل دیتا از طریق شبکه پرداخت. به عبارت دیگر، REST راهی ساده به منظور سازماندهی تعاملات مابین سیستمهای مجزا از یکدیگر می باشد.
در مقابل REST، پروتکل SOAP که مخفف واژگان Simple Object Access Protocol است قرار دارد که از طریق آن میتوان به رد و بدل دیتا از طریق شبکه در قالب وب سرویس های مختلفی با فرمت XML پرداخت.
API هم مخفف واژگان Application Programming Interface است که دربرگیرنده ی متدهایی برای ارتباط با سایر لایبرری ها یا اپلیکیشن ها است.
حال اگر این اصطلاحات در کنار یکدیگر قرار دهم و چیزی تحت عنوان RESTful API بسازم، منظورمان ساز و کارهایی برای ارتباط با سایر سرویس ها با استفاده از معماری خاصی است. معماری REST دارای یکسری ویژگیها است که شاخص ترین آنها عبارتند از:
- ثبات و یکنواختی این معماری در جای جای API
- عدم برخورداری از سشن در سمت سرور
- به کارگیری از کدهای وضعیت اچ تی تی پی
- استفاده از یو آر ال ها برای مشخص ساختن مسیرهای مد نظر
- اعمال کوئری ها در یو آر ال به جای هدر پروتکل اچ تی تی پی
با این تفاسیر، RESTful API ها به خدمت توسعه دهندگان وب آمدهاند تا فرایند توسعه ی وب، ایجاد تجربه ی کاربری بهتر، سهولت در استفاده از ای پی آی ها و نقل و انتقال دادهها از طریق پروتکل اچ تی تی پی را امکانپذیر سازند.
علاوه بر این، توجه داشته باشم که REST بیش از آنکه پروتکل باشد، یکسری راهنما، اصول و قواعدی است که با استفاده از آنها میتوانم به برقراری ارتباط مابین منابع مختلف بپردازم. حال برای درک بهتر این موضوع، مثالی عملی می زنم. فرض کنم که قصد دارم از ای پی آی شبکه ی اجتماعی توییتر برای نشان دادن محبوبترین توییت ها در وب سایت خود استفاده کنم. در چنین شرایطی، ما بدون آن که دسترسی به سرور این شبکه ی اجتماعی داشته باشیم، قادر خواهیم بود تا دیتای مد نظر خود را گرفته و در معرض دید کاربرانمان قرار دهم. معمولاً سرویس هایی که API در اختیار توسعه دهندگان قرار می دهند، دیتای مد نظر را در فرمت JSON در اختیار آنها قرار میدهند البته برخی سرویس ها هم هستند که از فرمت XML استفاده می کنند.
آشنایی با مفاهیم third party (سوم شخص) برنامه های شخص سوم (third party)، برنامه هایی هستند که برای کار درون سیستم عامل ها نوشته شده، اما به وسیله افراد یا شرکت ها به غیر از تولید کننده سیستم عامل نوشته میشوند. به عنوان مثال، سیستم های مایکروسافت به همراه بسته ای از چندین برنامه نرم افزاری می آیند. از اینها، هر برنامه ای که به وسیله مایکروسافت ایجاد شده باشد، یک برنامه شخص اول (first party) است. هر برنامه ای که به وسیله یک شرکت متفاوت یا یک فرد ایجاد شده باشد برنامه شخص سوم است؛ چنین چیزی در مورد سیستم های اپل و لینوکس نیز صادق است. در این معادله، شخص دوم (second party) کاربر است.
برنامه های شخص سوم میتوانند برنامه های مستقلی باشند یا می توانند پلاگین های کوچکی باشند که قابلیت هایی را به یک برنامه دیگر می افزایند. گروه پیشین بی پایان است. در یک سیستم معمولی، برنامه های شخص سوم مستقل شامل ده ها برنامه است. مرورگرهای وب همانند اپرا، سافاری و فایرفاکس و خدمات گیرنده های ایمیل همانند تاندربرد، !The Bat و Pegasus چند نمونه از برنامه های شخص سوم مستقل محبوب هستند. بیشتر برنامه های ضد ویروس، دیواره های آتش (firewallss)، برنامه های چند رسانه ای – در اصل هر برنامه ای که به وسیله مایکروسافت، اپل، یا لینوکس نوشته نشده باشد، و باز هم برای کار بر روی آن سیستم ها ساخته شده باشند – در این گروه قرار میگیرند. استفاده از یک برنامه شخص سوم، از لحاظ نظری درجه آسیب پذیری بالقوه را کاهش میدهد.
نوع متفاوتی از برنامه شخص سوم، قابلیت های اضافی را برای یک برنامه اصلی فراهم می کند. این نوع از برنامه های شخص سوم به عنوان پلاگین ها و افزونه ها شناخته می شوند. برنامه اصلی موجود خود ممکن است یک برنامه شخص سوم، یا یک برنامه شخص اول باشد. مثال ها عبارتند از پلاگین های رمزنگاری برای برنامه های ایمیل، پلاگین های چند رسانه ای برای مرورگرهای وب برای تماشای فیلم ها یا مشاهده محتوای فلش، یا پلاگین هایی که گونه های خاصی از فایل ها را میخوانند همچون پلاگین Adobe Acrobat مورد استفاده در مرورگرها برای خواندن فایل های pdf .
اگرچه پلاگین ها و افزونه ها برای برنامه های شخص اول نیز موجود هستند، اکثریت وسیعی برای نرم افزارهای متن باز (open source) نوشته میشوند. مایکروسافت و اپل کد منبع سیستم عامل های اختصاصی شان را در دسترس عموم قرار نمیدهند، و این توانایی یک شخص سوم برای نوشتن یک پلاگین یا افزونه را محدود میکند. بیشتر برنامه های شخص سوم نیز اختصاصی هستند، و یک شرکت کد منبع را به صورت محرمانه نگه میدارد. هرچند، برنامه های شخص سوم بسیاری وجود دارند که متنباز هستند و این گروه از نرم افزارها در حال رشد است. مرورگر وب فایرفاکس و خدمات گیرنده ایمیل تاندربرد (Thunderbird) تنها دو نمونه از برنامه های شخص سوم منبع باز هستند که خیلی محبوب هستند. این محبوبیت ناشی از فهرست در حال رشد افزونه ها و پلاگین های مناسب و سودمند است که برای این برنامه ها به صورت رایگان موجود هستند. برنامه های شخص اول منبع باز، به استثنای سیستم عامل های لینوکس که یک استثناء را ایجاد می کنند، کمیاب هستند.
همگام سازی ویتایگر با نرم افزار شخص سوم (REST APIs) REST API
از مزایای REST API ها ارسال و دریافت داده بر روی HTTP(s) از نرم افزار ویتایگر و یکپارچه سازی با نرم افزارهای شخص سوم می باشد. شما کاملا در انتخاب کتابخانه ای برنامه نویسی برای استفاده از API ها آزاد می باشید. برای کار کردن با REST API ها از طریق زبان های برنامه نویسی مختلف، Vtwsclib این امکان زا برای شما فراهم می سازد. http://code.vtiger.com/vtiger/vtigercrm-...r/vtwsclib
بخش زیر جزئیات بیشتری در مورد API ها ارائه میدهد:
فرمت Request (درخواست)
HTTP - GET / POST
application/x-www-form-urlencoded
فرمت Response (پاسخ)
موفق
عملیات ورود
این فرایند دو مرحله ای شامل دریافت کد چالش (توکن) و تبادل اعتبار نامه ها ( رمز عبور و کلید دسترسی) می باشد. شما می تواند اطلاعات کلید دسترسی (accessKey ) را در بخش "تنظیمات پروفایل من" در رابط کاربری وب نرم افزار خود پیدا کنید.
کد چالش (Challenge)
<column_list> کاما لیست نام فیلد ها را از هم جدا می کند
<object> نام ماژول
<conditionals> <condition_operations> یا <in_clauses> یا <like_clauses> به وسیله عملگرهای and یا or از یکدیگر جدا می شوند و از چپ به راست پردازش می شوند. هیچ گروه بندی وجود ندارد، تمام این موارد عملگرهایی هستند که در براکت می باشند.
<condition_operations> <, >, <=, >=, =, !=
<in_clauses> in ()
<like_clauses> مانند sqlregex
<value_list> کاما لیست مقادیر را جدا می کند.
m, n مقادیر را به ترتیب برای تعیین انحراف و محدوده همگام سازی می کند.
محدودیت ها
• کوئری ها در حال حاضر محدود به یک شی (object) منحصر بفرد می باشند
• اتصالات(Joins) پشتیبانی نمی شوند
• کوئری همواره خروجی خود را تا حدود 100 رکورد محدود می کند، نرم افزار کلاینت می تواند از عملگر های محدودی برای دریافت رکوردهای مختلف استفاده کند.
عملیات همگام سازی (Sync)
بعد از تکمیل فرآیند نصب ویتایگر بر روی xampp ، هنگام ورود با خطای اشتباه بودن یوزر و پسورد روبرو میشوم
چندین بار سعی کردم و مجددا اطلاعات را پاک کردم و دوباره نصب کردم اما باز هم موفق به ورود به سیستم نشدم
پس از درخواست های مکرر کاربران ویتایگر ، تیم پارس ویتایگر بر آن شد تا با انتشار ابزار رایگان بازیابی و تغییر رمز عبور ویتایگر بتواند کمک شایانی را به جامعه ویتایگر کاران در سراسر جهان نماید. از اینرو شما می توانید این افزونه را همراه با راهنمای کاملا تصویری از انجمن پارس ویتایگر دانلود ، نصب و استفاده نمایید.
لازم به ذکر است بزودی ماژول ها و امکانات بی نظیری را بصورت رایگان در این انجمن منتشر خواهیم کرد. تیم پارس ویتایگر همواره آماده دریافت نظرات ، انتقادات و پیشنهادات شما کاربران محترم می باشد.
بسته زبان ویتایگر فارسی به صورت ماژول نصبی برای ویتایگر شما می باشد، به این معنی که فقط شامل فایل های لازم برای سازگاری کامل ویتایگر شما با زبان فارسی است و شامل فایلهای خود ویتایگر نمی باشد. شما می توانید این بسته بر روی نسخه نصب شده وی خود اضافه نمایید.
درباره بسته
بسته های زبان فارسی ویتایگر، محصول اصلی تیم پارس ویتایگر است. این بسته ها شامل فایل های زبان برای فارسی سازی محیط مدیریت وکاربری ویتایگر می باشد.
این بسته که به صورت یک افزونه در دسترس عموم می باشد شما را قادر می سازد تا براحتی ویتایگر را به زبان فارسی تبدیل کنید. در این بسته علاوه بر زبان فارسی فایل زبان پورتال مشترکین نیز درون بسته قرار گرفته است.
نگارش 1.0.0
تاریخ انتشار : پاییز 1395 دریافت و نصب بسته کامل از فروشگاه ویتایگر به صورت فایل زیپ – 125 کیلوبایت دریافت و نصب بسته کامل از سایت پارس ویتایگر به صورت فایل زیپ – 125 کیلوبایت دریافت و نصب بسته زبان پورتال مشترکین از سایت پارس ویتایگر به صورت فایل زیپ – 18 کیلوبایت
[[راهنمای نصب ماژول برای ویتایگر]]
[[راهنمای نصب پورتال مشترکین ویتایگر]]
انشالا طی چند روز آینده بسته کامل نصبی ویتایگر ارائه می گردد
نکته: منظور از ماژول در ویتایگر بسته های زبان، افزونه های قابل نصب و قالب و پوسته می باشد.
1- نصب ماژول های موجود در فروشگاه:
در بخش تنظیمات مدیریت ویتایگر با کلیک برروی گزینه ی فروشگاه ماژول، در نوار تنظیمات پایین سمت راست و یا انتخاب گزینه فروشگاه ماژول در بخش استودیو ، مدیریت ماژول لیست تمامی ماژول های قابل نصب را مشاهده خواهید کرد ، پس از مشاهده ماژول ها رو به روی ماژول مربوطه با کلیک بر روی گزینه نصب امکان نصب هریک از آنها فراهم می باشد. البته برای نصب این روش شما نیازمند ایجاد حساب کاربری در فروشگاه ماژول ویتایگر و ورود جهت نصب می باشید
2- نصب فایل ماژول از بخش مدیریت ماژول :
ابتدا ماژول مورد نظر را از سایت مربوطه (سایت هایی که دارای ماژول های معتبر مربوط به ویتایگر می باشند) دانلود نموده و در مسیر مشخصی روی کامپیوتر خود ذخیره نمایید.
سپس برای نصب از این روش، از صفحه اصلی قسمت تنظیمات مدیریت و یا استودیو گزینه مدیریت ماژول را انتخاب و سپس گزینه نصب از طریق فایل زیپ را انتخاب نمایید
فایل مورد نظر خود که به صورت zip می باشد را انتخاب و فوانین نصب ماژول را مطالعه و با کلیک بر روی گزینه "ورود اطلاعات از فایل" به مرحله بعد بروید
در مرجله بعد نام ماژول و مستندات شامل مجوز های ماژول را مشاهده خواهید کرد. در صورتی که قوانین استفاده را می پذیرید بر روی وارد کردن اطلاعات کلیک کنید
در مرجله بعد پیامی مبنی بر نصب موفقیت آمیز ماژول مشاهده خواهید کرد و نصب به پایان می رسد
نکته:
الف: در صورتی که در زمان آپلود ماژول خطای فایل نامعتبر را دریافت کردید از صحت فایل زیپ و ساختار ماژول اطمینان حاصل نمایید.
ب: در صورتی که در زمان نصب خطای آپلود فایل را دریافت نمودید از دسترسی نوشتن در پوشه test/vtlib در پوشه مسیر روت ویتایگر اطمینان حاصل نمایید
ج: در صورتی که ماژول آپلود شده به صورت افزونه باشد شما می توانید آن را در بخش مدیریت ماژول و بسته به کارایی ماژول احتمالا آن را در بخش منوی همه و تنظیمات دیگر مشاهده نمایید
د: در صورتی که ماژول آپلود شده بسته زبان باشد کاربران می توانند آن را در بخش ویرایش مشخصات پروفایل با در قسمت زبان مشاهده نمایند
ه: در صورتی که ماژول آپلود شده بسته قالب باشد برای مشاهده آن به بخش ویرایشگر تنظیمات رفته و از قسمت پوسته پیشفرض آن را انتخاب نمایید این قابلیت ار ویتایگر 6.4 به بعد در دسترس است
3- نصب ماژول های از طریق vtlib:
یک فایل PHP در مسیر روت ویتایگر نصب شده ایجاد نمایید در قسمت به جای /path/to/modulename.zip مسیر فایل زیپ را روی سرور مشخص کنید
[فقط اعضای انجمن قادر به مشاهده محتوای این قسمت می باشند برای ثبت نام کلیک نمایید]
فایل ایجاد شده را از طریق PHP-CLI و یا از طریق بازکردن با مرورگر اجرا کنید تا ماژول نصب شود
مرحله دوم: manifest.xml
manifest.xml را ویرایش و اطلاعات پایه مورد نیاز برای دریافت افزونه نصب شده در نرم افزار ویتایگر را تکمیل نمایید.
[فقط اعضای انجمن قادر به مشاهده محتوای این قسمت می باشند برای ثبت نام کلیک نمایید]
Type:نوع ماژول را مشخص می کند که در آینده به تفضیل در مورد آن توضیح میدیم
Name: نام ماژول و پوشه نصب آن را مشخص می کند
Label: نامی که برای ماژول در سیستم نمایش داده می شود
Parent: نام بخشی در منو که ماژول در آن نمایش داده خواهد شد
Version: نسخه ماژول تولید شده توسط شما را نمایش می دهد
در بخش وابستگی ها
vtiger_version: حداقل نسخه ویتایگر برای نصب ماژول
vtiger_max_version: حداکثر نسخه ای که ماژول می تواند روی آن نصب شود 6.* به معنی همه نسخه های ورژن 6 است
مرحله 3: کلاس ماژول
فایل کلاس ماژول را به روز رسانی کنید (modules/HelloWorld/HelloWorld.php ).
نکته
نمایه پیش فرض برای این صفحه در ویتایگر نمایه لیست List View تنظیم شده است. شما می توانید آن را با نمایه های دیگر در ویتایگر جایگزین کنید
مرحله 5: قالب View
templates/List.tpl را ویرایش نمایید و کد HTML مورد نظر خود را در آن وارد نمایید. دقت نمایید قالب وارد شده بهتر است با bootstrap سازگار باشد
اصولا مدیران سیستم در ویتایگر می توانند کلمه عبور هر یک از کاربران را از بخش مدیریت سیستم تغییر داده و بازیابی کنند اما اگر کاربر مدیر در ویتایگر رمز عبور خود را فراموش کند و تنظیمات سرور ارسالی ایمیل در بخش تنظیمات سیستم اعمال نشده باشد یا ایمیل وارد شده در پروفایل کاربر معتبر نباشد ایمیلی حهت بازیابی به کاربر ارسال نمی شود و عملا امکان بازیابی رمز عبور از طریق ویتایگر غیر ممکن می شود
با خواندن این آموزش کوتاه به راحتی میتوانید رمز عبور خود را تغییر داده و وارد سیستم شوید:
روش اول تغییر پسورد admin از طریق دیتابیس
تنها در صورتی که نام کاربری که تصمیم به بازیابی آن دارید با دو حرف 'ad' شروع شود برای مثال admin قابل استفاده است:
برای این کار به قسمت phpMyAdmin بروید در سمت چپ بالا دیتابیس های موجود را می بینید. بر روی دیتابیس ویتایگر خود کلیک کنید تا جداول آن ظاهر شوند و یا به هر روش دیگری که ممکن است بانک اطلاعاتی خود را انتخاب کنید و دستور SQL زیر را اجرا کنید
دستور SQL برای کاربر با شناسه کاربری 1 و نام کاربری admin
پس از اجرای دستور زیر گذر واژه شما کلمه admin خواهد بود
این روش اگر نام کاربری برای مثال به manager تغییر یافته باشد پاسخگو نیست
روش دوم - استفاده از سیستم بازیابی پسورد پارس ویتایگر
ویتایگر برای ورود به سیستم از متد کدگذاری MD5 و یا BLOWFISH به همراه یک کلید که ترکیبی از دو کاراکتر اول نام کاربری به همراه چند کاراکتر دیگر نظیر $ استفاده می کند
همچنین اطلاعات کاربری در ویتایگر علاوه بر بانک اطلاعاتی در جدول vtiger_users در پوشه ای در مسیر روت ویتایگر به نام user_privileges ذخیره میشوند که شامل اطلاعات کاربری و دسترسی های کاربر می باشد. از این اطلاعات به جهت افزایش سرعت سیستم در کارکرد کاربران استفاده می شود لذا اگر شما برای مثال در برخی تنظیمات پروفایل از طریق دیتابیس تغییری ایجاد کنید این اطلاعات تا زمانی که در فایل های مسیر user_privileges اعمال نشوند کار نخواهند کرد و یا درصورتیکه اطلاعات این پوشه پاک شوند دیگر کاربر قادر به فعالیت نخواهند بود.
برای راحتی کار شما در امر بازیابی رمز ورود، به شما سیستم بازیابی رمز عبور را معرفی می کنم که علاوه بر بازیابی توانایی اعمال تغییرات را در فایل های دسترسی نیز به شما میدهد
1- برای شروع فایل ضمیمه را دریافت کنید
2- فایل را از حالت فشرده خارج کنید
3- می توانید فایل password.php را ویرایش کنید، نام کاربری و کلمه عبور دلخواهی برای دسترسی به این فایل در خطوط اول مشخص نمایید این کار امنیت شما را در دسترسی های بعدی تضمین می کند
6- نام کاربری و گذرواژه مرحله 3 را وارد کنید تا محیط برنامه تغییر کلمه عبور ویتایگر را برنامه مشاهده نمایید.
7- در این قسمت نام کاربری که تصمیم به تغییر رمز آن دارید را انتخاب نمایید. سپس گذرواژه دلخواه را وارد نمایید
در پایین فرم انتخاب گزینه Recreate User Privilege Files به شما اجازه تغییر رمز را به همراه اعمال تغییرات روی فایل های پوشه user_privileges می دهدتا عملیات تغییر رمز مشابه عملیات سیستم باشد و گزینه Ignore User Privilege Files تنها گذرواژه را در بانک اطلاعاتی تغییر می دهد با این فایل شما دیگر مشکلی با تغییر گذرواژه کلیه کاربران سیستم نخواهید داشت