Встановити з JED (для розробників розширень)

Матеріал із Joomla! Documentation

[Починаючи з] Joomla! 3.2 надається новий функціонал – установка через інтернет, яка дозволяє встановлювати перераховані на JED [(офіційному каталозі сторонніх розширень Joomla!)] розширення. Для включення Вашого розширення до списку [розширень] на JED та їх встановлення через інтернет, [необхідно виконати] два кроки:

Заповніть два нових поля на JED
Налаштуйте свій сайт відповідно

Зміст

Заповніть два нові поля на [сайті каталогу] JED

Якщо ви відкриєте запис вашого розширення на JED для редагування, ви побачите два нових поля.

Перше -Download Type[(у перекладі -Тип скачування)], де для свого розширення Ви зможете вибрати тип скачування з наступних чотирьох опцій:

None [(у перекладі -Без скачування)]
Free Direct Download Link: [(у перекладі -Безкоштовне завантаження безпосередньо за посиланням:)]
Free but Registration Required at Link: [(у перекладі -Безкоштовно, але з обов'язковою реєстрацією за посиланням:)]
Commercial Purchase Required at Link: [(у перекладі -Необхідна комерційна покупка за посиланням:)]

Зверніть увагу, будь ласка:кешування на сервері для функціоналу "Встановити з JED" налаштовано на від 2 до 6 годин, так що Ви швидше за все не побачите змін у своїй адміністративній панелі відразу.

Якщо Ваше розширення [надається] для скачування за посиланням безпосередньо, Ви виконали все що потрібно і можете ігнорувати другий крок.

Ось трохи докладнішої інформації за типами скачування.

Це найпоширеніший на сьогодні сценарій і в основному означає, що Ви не можете або не бажаєте надаватипряме завантаження свого розширення. На JEC заповнені лише обов'язкові поля та поля для "Встановити з JED" залишаються незаповненими.

Коли користувач заходить у свою адміністративну панель і клацає на вкладку "Встановити з JED", то Ваше розширення можна побачити, кнопка "Завантажити" показана, але відсутня кнопка "Встановити".

Free Direct Download Link

Якщо розширення надається безкоштовно, тобто. без реєстрації та покупки, то вибирайте цю опцію. Для "Download/registration/purchase URL" Вам слід ввести посилання на XML файл оновлення, або посилання на [установковий] ZIP архів.

Коли користувач заходить у свою адміністративну панель і клацає по кнопці "Встановити з JED", Ваше розширення буде показано і з'явиться кнопка "Встановити", так що цей користувач зможе клацнути на неї і встановити це Ваше розширення.

Free but Registration Required at Link

Вибирайте цю опцію, якщо для завантаження Вашого розширення потрібна реєстрація. У полі "Download/registration/purchase URL" Вам необхідно ввести URL-адресу посилання свого веб-сайту на сторінку реєстрації.

Коли користувач заходить у свою адміністративну панель [Joomla!] і клацає на вкладку "Встановити з JED", то Ваше розширення можна буде знайти і з'явиться кнопка "Встановити". Коли цей користувач клацне на цю кнопку установки, він буде перенаправлений на веб-сторінку реєстрації на Вашому веб-сайті.

Якщо Ви налаштували свій веб-сайт правильно (дивіться нижче другий крок), то після успішної реєстрації користувач буде перенаправлений назад на свій веб-сайт для завершення установки з JED.

Commercial Purchase Потрібно в Link

Якщо для завантаження Вашого розширення необхіднакупівля, вибирайте цю опцію. Для поля "Download/registration/purchase URL" Вам необхідно ввести URL-адресу посилання на веб-сторінку продажу Вашого розширення.

Якщо Ви налаштували свій веб-сайт правильно (дивіться нижче другий крок), то після успішної покупки користувач буде перенаправлений назад на свій веб-сайт для завершення установки з JED.

[А що щодо підписки? Вона більше заснована на реєстрації або купівлі?]

Налаштування Вашого веб-сайту

Як було зазначено раніше, якщо Ваше розширення надається безкоштовно, без необхідності реєстрації та покупки, то Вам не потрібно більше нічого робити. Пропустіть цей крок.

Налаштування Вашого веб-сайту та розширень безкоштовні, але потрібна реєстрація за посиланням на розширення

Якщо Ви вимагаєте, щоб покупець реєструвався, Вам необхідно налаштувати на своєму веб-сайті реєстрацію користувачів.

Якщо ні, то користувач заповнює реєстрацію та останній крок установки з JED НЕ завершено.

Як працює установка з JED

Коли користувач клацає по кнопці "Встановити", Joomla! надсилає [дані через] такі параметри:

installatє зворотним URL посиланням таinstallapp- це ID номер розширення на JED.

Для заповнення кроку веб-установки Ваш адміністративний розділ повинен приймати ці параметри, обробляти реєстрацію та повертатися до URL посиланняinstallat.

Поки що заповнюєтьсяі обробляється реєстрація, Joomla очікує отримання URL посилання zip архіву або оновлень URL XML. Як тільки [одна з] отримана, Joomla! завершує цю установку.

Веб-установка з jefreg-plugin

jefreg-plugin- це еталонне застосування. Хороша відправна точка, яка була розроблена спеціально для цих цілей, може бути знайдена тут.

Це плагін містить два параметри:

Перший параметр, який Вам необхідно налаштувати -Files to Download[(у буквальному перекладіФайли для скачування) має своїм призначенням] направити цей плагін на XML файли оновлень Ваших розширень, ZIP файли або скрипти (по одному на рядок).

Якщо цей рядок починається зі знака зірочки [*], то вона буде пропущена і буде надана для обробки плагінами, які підтримують завантаження після отримання оплати. Приклади таких плагінів можна знайти у згаданому вище репозиторії.

За URL посиланням [точки] входу: цей плагін розроблений спеціально для компонента користувачів Joomla! (значення за умовчанням index.php?option=com_users&view=login), проте він також чудово інтегрується з будь-якою сторінкою реєстрації: наприклад, у випадку з [компонентом] "Community Builder" змінюючи URL посилання точки входу в параметрах плагіна - в цілому це рекомендується (але не обов'язково), щоб направити це на Вашу сторінку входу [в обліковий запис]. Зауважте, що пусте значення цього параметра за промовчанням надсилатиме на сторінку входу [в обліковий запис] компонента користувачів Joomla.

Як створити плагін jefreg-plugin

Завантажте всі файли з GitHub
Скопіюйте всі файли до директорії системного плагіна
Створіть ZIP пакет всіх файлів та встановіть його через менеджер розширень

НалаштуванняВашого веб-сайту та розширень на комерційні розширення

[У порівнянні з] попереднім кроком, для цього потрібно попрацювати якомога більше. Рекомендується завантажити той самий плагін, проте Вам буде необхідно інтегрувати в нього додаткову перевірку, щоб подивитися чи купив цей користувач Ваше розширення. Оскільки різні розширення застосовують цю [перевірку] багатьма різними способами, застосування цього функціоналу залишається за розробниками розширень.

Цей плагін може бути використаний для отримання параметрівinstallatтаinstallapp, але він НЕ ПОВИНЕН повертати URL-адресу посилання ZIP архіву або оновлення XML по входу користувача в його обліковий запис. Коли покупка завершена, ця операція може повернутися на заповнення установки з JED.

Вихідний код на майбутнє

Ви можете надіслати код для виправлення програмних помилок та нових характеристик на наступні репозиторії: