پلاگین Gmail

پلاگین Gmail

پلاگین Gmail یک پایگاه داده ستکا را با صندوق ورودی Gmail ادغام می کند، بنابراین کاربران می توانند تمام کارهای خود را بین Gmail و ستکا بدون از دست دادن اطلاعات پیگیری کنند.

کاربران انلاین ستکا


برای پایگاه داده های میزبانی شده در ستکا انلاین (یا satka.sh)، مراحل زیر را برای پیکربندی افزونه Gmail دنبال کنید.

افزونه جیمیل را نصب کنید

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

از صندوق ورودی Gmail، روی نماد علامت مثبت در پانل سمت راست کلیک کنید تا افزونه‌ها را دریافت کنید. اگر پانل کناری قابل مشاهده نیست، روی نماد فلش در گوشه سمت راست پایین صندوق ورودی کلیک کنید تا نمایان شود.


سپس، از نوار جستجو برای جستجوی ستکا استفاده کنید و افزونه ستکا را پیدا کنید.

یا مستقیماً به صفحه افزودنی صندوق ورودی ستکا در بازار Google Workspace بروید.


پس از یافتن افزونه، روی Install کلیک کنید. سپس روی Continue کلیک کنید تا نصب شروع شود.


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

پایگاه داده ستکا را پیکربندی کنید

ویژگی Mail Plugin باید در پایگاه داده ستکا فعال باشد تا بتوان از افزونه Gmail استفاده کرد. برای فعال کردن این ویژگی، به تنظیمات  تنظیمات عمومی بروید. در بخش ادغام ها، Mail Plugin را فعال کنید و سپس روی ذخیره کلیک کنید.

صندوق ورودی جیمیل را پیکربندی کنید

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

بعد روی ورود کلیک کنید. سپس، آدرس پایگاه داده ستکا را که کاربر می خواهد به صندوق ورودی Gmail متصل شود، وارد کنید و وارد پایگاه داده شوید.

توجه داشته باشید


از URL عمومی برای پایگاه داده استفاده کنید، نه از URL یک صفحه خاص در پایگاه داده. برای مثال، از https://mycompany.satka.com استفاده کنید، نه https://mycompany.odoo.com/web#cids=1&action=menu.

در نهایت روی تایید کلیک کنید تا Gmail به پایگاه داده ستکا دسترسی پیدا کند. سپس مرورگر یک موفقیت را نشان می دهد! پیام پس از آن، پنجره را ببندید. صندوق ورودی Gmail و پایگاه داده ستکا اکنون متصل شده اند.

کاربران ستکا در محل


برای پایگاه‌های داده‌ای که روی سرورهایی غیر از ستکا انلاین (یا satka.sh) میزبانی می‌شوند، مراحل زیر را برای پیکربندی افزونه Gmail دنبال کنید.

توجه


Google به عنوان بخشی از دستورالعمل‌های امنیتی خود، از سازندگان افزونه‌ها می‌خواهد فهرستی از ادرس اینترنتی هایی را ارائه دهند که می‌توانند در اقدامات و هدایت‌های راه‌اندازی شده توسط این افزونه استفاده شوند. برای مثال، این کار با اطمینان از اینکه هیچ افزونه ای کاربران را به سمت یک وب سایت مخرب هدایت نمی کند، از کاربران محافظت می کند. (در Google Apps Script بیشتر بخوانید.)


از آنجایی که ستکا فقط می‌تواند دامنه satka.com را فهرست کند و نه دامنه سرور منحصر به فرد هر مشتری داخلی، مشتریان داخلی نمی‌توانند افزونه Gmail را از Google Workspace Marketplace نصب کنند.

افزونه جیمیل را نصب کنید

ابتدا به مخزن GitHub برای پلاگین های ایمیل ستکا دسترسی پیدا کنید. بعد روی دکمه سبز کد کلیک کنید. سپس، روی Download ZIP کلیک کنید تا فایل‌های افزونه Mail را در رایانه کاربر دانلود کنید.

فایل ZIP را در رایانه باز کنید. سپس، به نماهای mail-client-extensions-master ‣ gmail ‣ src ‣ بروید و فایل login.ts را با استفاده از هر نرم افزار ویرایشگر متنی مانند Notepad (ویندوز)، TextEdit (Mac)، یا Visual Studio Code باز کنید.


سه خط متن زیر را از فایل login.ts حذف کنید:


​if (!/^https:\/\/([^\/?]*\.)?satka\.com(\/|$)/.test(validatedUrl)) { ​return notify("The URL must be a subdomain of satka.com"); ​}

این محدودیت دامنه satka.com را از برنامه Gmail Plugin حذف می کند.


بعد، در فایل ZIP، به mail-client-extensions-master ‣ gmail بروید و فایلی به نام appsscript.json را باز کنید. در بخش urlFetchWhitelist، همه مراجع به satka.com را با دامنه سرور منحصر به فرد مشتری ستکا جایگزین کنید.


سپس در همان پوشه gmail فایلی به نام README.md را باز کنید. دستورالعمل‌های موجود در فایل README.md را دنبال کنید تا فایل‌های افزونه Gmail را به‌عنوان یک پروژه Google فشار دهید.

توجه
کامپیوتر باید بتواند دستورات لینوکس را اجرا کند تا از دستورالعمل های موجود در فایل README.md پیروی کند.

پس از آن، پروژه Google را با حساب Gmail که کاربر می‌خواهد به ستکا متصل شود، به اشتراک بگذارید. سپس روی Publish and Deploy from manifest کلیک کنید. در آخر برای نصب افزونه جیمیل بر روی Install the add-on کلیک کنید.

پایگاه داده ستکا را پیکربندی کنید

ویژگی Mail Plugin باید در پایگاه داده ستکا فعال باشد تا بتوان از افزونه Gmail استفاده کرد. برای فعال کردن این ویژگی، به تنظیمات ‣ تنظیمات عمومی بروید. در بخش ادغام ها، Mail Plugin را فعال کنید و سپس روی ذخیره کلیک کنید.

صندوق ورودی جیمیل را پیکربندی کنید

در صندوق ورودی Gmail، یک نماد ستکا بنفش اکنون در پانل سمت راست قابل مشاهده است. روی نماد ستکا کلیک کنید تا پنجره پلاگین ستکا باز شود. سپس، روی هر ایمیلی در صندوق ورودی کلیک کنید. برای اعطای دسترسی ستکا به صندوق ورودی جیمیل، در پنجره افزونه روی مجوز دسترسی کلیک کنید.

بعد روی ورود کلیک کنید. سپس، آدرس پایگاه داده ستکا را که کاربر می خواهد به صندوق ورودی Gmail متصل شود، وارد کنید و وارد پایگاه داده شوید.

توجه
از URL عمومی برای پایگاه داده استفاده کنید، نه از URL یک صفحه خاص در پایگاه داده. برای مثال، از https://mycompany.satka.com استفاده کنید، نه https://mycompany.satka.com/web#cids=1&action=menu.

در نهایت روی تایید کلیک کنید تا Gmail به پایگاه داده ستکا دسترسی پیدا کند. سپس مرورگر یک موفقیت را نشان می دهد! پیام پس از آن، پنجره را ببندید. صندوق ورودی Gmail و پایگاه داده ستکا اکنون متصل شده اند.