meetletacbfree/README.md

MeetLet Adobe Connect Bridge — Marketplace Edition

Component: mod_meetletacbfree
Release: 1.1.4
License: GNU GPL v3 or later

Connect Moodle to Adobe Connect for live classes, single sign-on (SSO), recordings, and shared meeting content — without a separate Windows agent or commercial license.

Designed for the Moodle Plugins Directory and self-hosted Moodle sites that want a production-ready Adobe Connect integration out of the box.

---

Overview

MeetLet Adobe Connect Bridge (Marketplace edition) is a Moodle activity module that lets teachers create or link Adobe Connect meetings directly from a course. Learners join with one click through HTTP header SSO. Site administrators configure the Adobe Connect server once; role mapping and feature access are managed from a clear, tabbed admin interface.

This edition is free to install and use. It includes the core classroom workflow: meetings, SSO, role mapping, recordings, and content — everything most institutions need to run live sessions from Moodle.

---

Features

Area	What you get
Meetings	Create new Adobe Connect rooms or link existing server meetings from the activity form
Single sign-on	HTTP header SSO — users join without a separate Connect login; no Windows Agent required
Role mapping	Map Moodle roles (and individual users) to Adobe Connect Host, Presenter, or Participant
Feature access matrix	Per-role control over join, recordings, content, recording rename, Adobe editor, and early entry
Recordings	Browse, play, and rename session recordings; open the Adobe Connect recording editor
Content	View and download files uploaded to the meeting room
Meeting status	Live room status (scheduled, in progress, waiting for host, ended) refreshed from the server
Connection test	Step-by-step admin test for API login, folders, user provisioning, and SSO
Server setup guide	In-plugin checklist for custom.ini, web.xml, and Connect service configuration
Activity defaults	Site-wide meeting language, wait-for-host, and tab visibility with per-activity overrides
Backup & restore	Standard Moodle 2 backup API support for course copies and restores
Privacy API	GDPR-ready privacy provider for exported and deleted user data
Plugin activation	Voluntary administrator action with MeetLet; required to unlock meeting features (SSO join, recordings, content, and related tools)

---

Marketplace Edition Scope

The Marketplace edition is a complete, self-contained integration for live teaching. The following capabilities are part of the commercial MeetLet Adobe Connect Bridge at meetlet.net:

Capability	Marketplace	Commercial
Meeting create / link	Yes	Yes
HTTP header SSO	Yes	Yes
Role mapping & access matrix	Yes	Yes
Recordings & content tabs	Yes	Yes
Connection test & server guide	Yes	Yes
MeetLet license platform	—	Yes
Attendance reports & CSV export	—	Yes
Offline MP4 generation & download	—	Yes
Windows Render Agent & video queue	—	Yes
Priority support & deployment consulting	—	Yes

If your organisation needs attendance analytics, offline video, or agent-based rendering at scale, the commercial edition extends this same plugin architecture with those enterprise features.

---

Requirements

Moodle

Requirement	Version
Moodle	4.5 LTS or later (through 5.2)
Plugin maturity	Stable

Adobe Connect Server

• Adobe Connect 11.x (or compatible) with XML API enabled
• Administrator account for API calls
• HTTP header authentication configured (HTTP_AUTH_HEADER and HTTP_AUTH_TRUSTED_HOSTS in custom.ini)
• HeaderAuthenticationFilter enabled in web.xml (see the in-plugin Server setup guide tab)

PHP (on the Moodle server)

Extension	Purpose
cURL	Adobe Connect XML API and SSO requests
JSON	Role mapping and feature-access configuration
OpenSSL	HTTPS connections to Adobe Connect
SimpleXML or libxml	Parsing Adobe Connect API responses

Standard Moodle PHP requirements also apply.

---

Installation

From a ZIP package (recommended for production)

1. Download or build a ZIP whose top-level folder is named meetletacbfree (not mod_meetletacbfree).
2. In Moodle, go to Site administration → Plugins → Install plugins.
3. Upload the ZIP and follow the on-screen prompts.
4. Complete the upgrade when prompted.

Manual copy

1. Copy the meetletacbfree folder into your Moodle mod/ directory:

   mod/meetletacbfree/
   

2. Log in as administrator and open Site administration → Notifications to run the upgrade.

After installation

1. Go to Site administration → Plugins → Activity modules → Adobe Connect Bridge (Marketplace edition).
2. Complete the Server setup guide and Server settings tabs.
3. Run the Connection test until all steps pass.
4. Add an Adobe Connect activity to a course and verify join and recordings.

Plugin activation (required)

Free plugin activation with MeetLet is required before meetings, SSO join, recordings, and other features unlock. Activation is voluntary in the sense that nothing is sent until an administrator clicks the button — but the plugin does not function until activation succeeds.

1. Open Plugin activation in the plugin admin settings (first tab).
2. Review what data is sent and click Activate plugin.
3. MeetLet receives your domain, installation ID, plugin version, and site contact details at https://license.webatsign.com (configurable).
4. A daily scheduled task re-validates activation only while activated. You can deactivate at any time; features lock again until you re-activate.

---

Configuration

Admin settings are organised in tabs under Site administration → Plugins → Activity modules → Adobe Connect Bridge (Marketplace edition):

Tab	Purpose
Server setup guide	Step-by-step Adobe Connect server configuration (custom.ini, web.xml, service restart)
Server settings	XML API URL, meeting domain, port, HTTPS, admin credentials, HTTP auth header, legacy email login
Plugin activation	Free activation with MeetLet (required to unlock all features; voluntary click — no silent phone-home)
Connection test	Live diagnostic: admin login, shared folders, test user, SSO, cleanup
Meeting settings	Default meeting language, wait-for-host, recordings tab and content tab visibility
Access settings	Moodle → Adobe Connect role mapping; site-wide feature-access matrix; per-activity override toggle
About the plugin developer	MeetLet product information and link to the commercial edition

Teachers can override role mapping and feature access per activity when the site allows it.

---

Commercial Edition

The Marketplace edition is maintained by MeetLet — specialists in Adobe Connect infrastructure for education and training.

For attendance reporting, offline MP4 video, Windows Render Agent integration, licensing, and dedicated support, visit meetlet.net.

---

Support

• Website: https://meetlet.net
• Email: info@meetlet.net
• Moodle Plugins Directory: use the plugin's support tab for community questions on the free edition

---

License

This plugin is free software licensed under the GNU General Public License v3.0 or later. See COPYING.txt for the full text.

---

---

پل Adobe Connect میت‌لت — نسخه Marketplace

کامپوننت: mod_meetletacbfree
نسخه: 1.0.9-marketplace
مجوز: GNU GPL v3 یا بالاتر

اتصال مودل به Adobe Connect برای کلاس آنلاین، ورود یک‌مرحله‌ای (SSO)، ضبط جلسات و محتوای اشتراکی — بدون نیاز به Agent ویندوز یا لایسنس تجاری.

این افزونه برای فهرست افزونه‌های مودل و سایت‌های خودمیزبان طراحی شده است.

---

معرفی

افزونه Adobe Connect Bridge (نسخه Marketplace) یک ماژول فعالیت مودل است که به مدرس امکان می‌دهد جلسات Adobe Connect را از داخل درس ایجاد یا به جلسات موجود متصل کند. فراگیران با یک کلیک و از طریق SSO هدر HTTP وارد جلسه می‌شوند. مدیر سایت یک‌بار سرور Connect را پیکربندی می‌کند؛ نگاشت نقش‌ها و دسترسی‌ها از رابط مدیریتی تب‌دار انجام می‌شود.

این نسخه رایگان و آماده استفاده در محیط تولید است و جریان اصلی کلاس آنلاین را پوشش می‌دهد.

---

امکانات

بخش	توضیح
جلسات	ایجاد اتاق جدید یا اتصال به جلسات موجود روی سرور
ورود یک‌مرحله‌ای (SSO)	بدون لاگین جداگانه Connect؛ بدون Agent ویندوز
نگاشت نقش	نگاشت نقش‌ها و کاربران مودل به Host، Presenter یا Participant در Connect
ماتریس دسترسی	کنترل نقش‌به‌نقش برای ورود، ضبط‌ها، محتوا، ویرایش نام ضبط، ویرایشگر Adobe و ورود زودهنگام
ضبط‌ها	مشاهده، پخش و تغییر نام ضبط‌ها؛ ویرایشگر ضبط Adobe Connect
محتوا	مشاهده و دانلود فایل‌های آپلودشده در اتاق جلسه
وضعیت جلسه	وضعیت زنده (برنامه‌ریزی‌شده، در حال برگزاری، انتظار برای میزبان، پایان‌یافته)
تست اتصال	تست گام‌به‌گام برای API، پوشه‌ها، کاربر آزمایشی و SSO
راهنمای راه‌اندازی سرور	چک‌لیست custom.ini، web.xml و سرویس Connect داخل افزونه
پیش‌فرض‌های فعالیت	زبان جلسه، انتظار برای میزبان و نمایش تب‌ها با امکان تغییر در هر فعالیت
پشتیبان‌گیری و بازیابی	پشتیبانی از API پشتیبان مودل ۲
حریم خصوصی	ارائه‌دهنده Privacy API سازگار با GDPR
ثبت اختیاری سایت	ثبت شفاف و اختیاری در MeetLet برای اعلان به‌روزرسانی و آمار پشتیبانی (بدون ثبت هم کامل کار می‌کند)

---

محدوده نسخه Marketplace

نسخه Marketplace برای تدریس زنده کامل و مستقل است. قابلیت‌های زیر در نسخه تجاری MeetLet Adobe Connect Bridge در meetlet.net ارائه می‌شوند:

قابلیت	Marketplace	تجاری
ایجاد / اتصال جلسه	بله	بله
SSO هدر HTTP	بله	بله
نگاشت نقش و ماتریس دسترسی	بله	بله
تب ضبط‌ها و محتوا	بله	بله
تست اتصال و راهنمای سرور	بله	بله
پلتفرم لایسنس MeetLet	—	بله
گزارش حضور و غیاب و خروجی CSV	—	بله
تولید و دانلود MP4 آفلاین	—	بله
Render Agent ویندوز و صف ویدیو	—	بله
پشتیبانی اولویت‌دار و مشاوره استقرار	—	بله

---

پیش‌نیازها

مودل

مورد	نسخه
مودل	۴.۵ LTS یا بالاتر (تا ۵.۲)

سرور Adobe Connect

• Adobe Connect 11.x (یا سازگار) با XML API فعال
• حساب مدیر برای فراخوانی API
• احراز هویت هدر HTTP (HTTP_AUTH_HEADER و HTTP_AUTH_TRUSTED_HOSTS در custom.ini)
• فعال‌سازی HeaderAuthenticationFilter در web.xml (راهنمای داخل افزونه)

PHP (روی سرور مودل)

افزونه	کاربرد
cURL	API و درخواست‌های SSO
JSON	پیکربندی نگاشت نقش و دسترسی
OpenSSL	اتصال HTTPS
SimpleXML / libxml	پردازش پاسخ API

---

نصب

از فایل ZIP (توصیه‌شده)

1. ZIP را طوری آماده کنید که پوشه سطح اول آن meetletacbfree باشد.
2. در مودل: مدیریت سایت → افزونه‌ها → نصب افزونه‌ها.
3. ZIP را آپلود و مراحل را تکمیل کنید.
4. ارتقای پایگاه داده را اجرا کنید.

کپی دستی

پوشه meetletacbfree را در mod/ قرار دهید و از مدیریت سایت → اعلان‌ها ارتقا را اجرا کنید.

پس از نصب

1. مدیریت سایت → افزونه‌ها → ماژول‌های فعالیت → Adobe Connect Bridge (Marketplace edition)
2. تب‌های راهنمای راه‌اندازی سرور و تنظیمات سرور را تکمیل کنید.
3. تست اتصال را تا موفقیت همه مراحل اجرا کنید.
4. یک فعالیت Adobe Connect به درس اضافه و ورود و ضبط‌ها را آزمایش کنید.

فعال‌سازی پلاگین (الزامی)

فعال‌سازی رایگان پلاگین با MeetLet برای باز شدن جلسات، ورود SSO، ضبط‌ها و سایر امکانات لازم است. فعال‌سازی داوطلبانه است به این معنا که تا کلیک مدیر هیچ داده‌ای ارسال نمی‌شود — اما بدون فعال‌سازی موفق، افزونه کار نمی‌کند.

1. تب فعال‌سازی پلاگین را در تنظیمات افزونه باز کنید (تب اول).
2. داده‌های ارسالی را بخوانید و فعال‌سازی پلاگین را بزنید.
3. دامنه، شناسه نصب، نسخه افزونه و تماس سایت به https://license.webatsign.com ارسال می‌شود (قابل تغییر).
4. وظیفه روزانه فقط در صورت فعال بودن، وضعیت را تازه می‌کند. با غیرفعال‌سازی، امکانات دوباره قفل می‌شوند.

---

پیکربندی

تب	کاربرد
راهنمای راه‌اندازی سرور	پیکربندی custom.ini، web.xml و راه‌اندازی مجدد سرویس
تنظیمات سرور	URL API، دامنه جلسه، پورت، HTTPS، اعتبار مدیر، هدر احراز هویت
فعال‌سازی پلاگین	فعال‌سازی رایگان با MeetLet (برای باز شدن همه امکانات؛ فقط با کلیک مدیر — بدون ارسال خودکار)
تست اتصال	تشخیص زنده: لاگین، پوشه‌ها، کاربر آزمایشی، SSO
تنظیمات جلسه	زبان پیش‌فرض، انتظار برای میزبان، نمایش تب ضبط‌ها و محتوا
تنظیمات دسترسی	نگاشت نقش؛ ماتریس دسترسی سراسری؛ امکان تغییر در هر فعالیت
درباره توسعه‌دهنده افزونه	اطلاعات MeetLet و لینک نسخه تجاری

---

نسخه تجاری

نسخه Marketplace توسط MeetLet — متخصص زیرساخت Adobe Connect برای آموزش — نگهداری می‌شود.

برای گزارش حضور، ویدیوی MP4 آفلاین، Render Agent ویندوز، لایسنس و پشتیبانی اختصاصی به meetlet.net مراجعه کنید.

---

پشتیبانی

• وب‌سایت: https://meetlet.net
• ایمیل: info@meetlet.net

---

مجوز

این افزونه نرم‌افزار آزاد تحت GNU General Public License نسخه ۳ یا بالاتر است. متن کامل در COPYING.txt.