Ми представляємо Jumi 2,1 бета-версії Joomla! 1,5 тут. Є так багато змін у цій версії!

Коли 2,1 бета змін до фінальної версії і 2.0 буде позначений як знецінилися ми будемо включати цей документ в стандартній документації Jumi.

Intro

Jumi плагін синтаксис змінився (після трьох років) на будь-який інший. Існує ніякої зворотної сумісності в цей синтаксис, однак ви можете використовувати всі попередні митних кодів і функцій в 2,1 реліз (і використовувати нові).

Є не зміни в плагін тільки синтаксис. Зміни в інших місцях. Так що читайте документ уважно, будь ласка.

Для тих, хто надто прагнуть спробувати нові версії або ненавидіти наступним чином: "все таке" тут Швидкі & Dirty зміни плагін синтаксис:

Старий плагін Jumi синтаксис

{Jumi [stored_code_source] [arg1] [arg2] ... [ArgN]}

Новий плагін Jumi синтаксис

{} Jumi stored_code_source written_code {/ jumi}

Як зробити перехід до Jumi 2,1 синтаксис? Ми пояснимо це нижче. Але про все по порядку.

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

Набір розширень Jumi

Jumi 2,1 складається з кількох взаємозалежних розширеннями:

• Jumi система плагінів (Повністю переписаний!)
  дозволяє включити настроювані коди з декількох ресурсів в Joomla! статей, зміст і категорії опису.
  Вона встановлює Jumi Вболівай за Jumi компонент і Jumi модуля. Коди обробляються в PDF-версії Joomla! Зміст і роздягли з RSS.
  
• Jumi редактор XTD (Англ.)
  є Joomla! Редактор кнопки, що дозволяє коду / декодування скриптів для їх прямого включення в Joomla! Зміст і подальшої обробки систему плагінів Jumi.
• Jumi компонент (+ Загальні Jumi Коренева використання)
  створює користувальницькі Joomla! сторінок (так званий Jumi Додатки), що містить користувальницький код.
• Jumi SEF маршрутизатор
  являє собою систему плагін, який підтримує Jumi компоненти: Він забезпечує прямий доступ з Jumi додатків з його псевдонім (наприклад, http://www.mysite.com/hello-jumi).
• Jumi модуль (+ Режим відладки, + Загальні Jumi Коренева використання)
  простий модуль, який дозволяє включити настроювані коди з декількох ресурсів в Joomla! Модуль позиції.
• Мови
  крім плагіна маршрутизатора Jumi Є мовні файли для усіх розширень Jumi їх легко переклади.

Jumi 2,1 вимоги

Нічого не менш Joomla! 1.5.8 не потрібно.

Оновлення з попередньої версії

Ми рекомендуємо, щоб повністю видалити всі попередні розширення Jumi і встановити Jumi 2,1 пакеті. Розглянемо наступне:

Якщо ви хочете використовувати ваш старий компонент Jumi таблиці бази даних в новому Jumi 2,1, то його резервну копію спочатку бази даних утиліти ви використовуєте (наприклад, PhpMyAdmin). Після установки нового пакету, який ви відновити початковий компонент Jumi таблиці бази даних.

Старі Jumi Плагін синтаксис не будуть оброблятися новим плагіном. Вам доведеться переписувати кожен старого примірника синтаксис плагін. Ми дуже жалкуємо про доставлених незручності вона принесе вам. З іншого боку, вона принесе вам більше можливостей, більш високий рівень безпеки і більшої гнучкості. Щось чогось.

Також пам'ятайте, що всі Jumi Модулі будуть знищені в процесі деінсталяції. Тому ми рекомендуємо, щоб до відома весь зміст Jumi модулів принаймні.

Jumi 2,1 установки

Встановіть пакет в якості стандартної Joomla! розширення. Всі Jumi розширень які при цьому встановлюються одним клацанням процесу. Всі Jumi плагіни встановлені на "Enable" теж.

У Jumi 2,1 немає демо головного меню "Hello Jumi!" елемент, видимий в інтерфейсі як це було в Jumi 2.0. Деякі наші користувачі ненавидять його навіть як демо. Якщо ви хочете, ви повинні зробити її видимою вручну: піти в бекенда і публікувати встановленою пункт меню "Hello Jumi!" там.

Наступні кроки

Використання Jumi компонентів, модулів і маршрутизатор може бути виведено з попередніх версій або документації, ця шпаргалка.

Jumi плагін вимагає більш докладного пояснення. Оскільки при цьому використовується інший інструмент: Jumi редактор XTD (кнопка) плагін, який кодує / декодує користувальницькі скрипти таким чином, вони не видаляються з Joomla! й обробляються плагін Jumi.

В іншій частині статті ми розповімо:

1. Як писати коди в Joomla! зміст з Jumi кодера (кодова назва Jumi редактор XTD плагін).
2. Як редагувати коди в Joomla! зміст з Jumi кодер.
3. Як перенести старий плагін Jumi синтаксис для нового.
4. Jumi плагін безпеки й інші зауваження.

Використання Jumi кодер

Ну, подивитися відео в першу чергу. Ми пояснимо його після цього.

Так як це працює?

Ви знаєте, коли ви дозволите спеціальний скрипт в Joomla! Стаття код буде видалений з, або, в кращому випадку, кодуються в HTML сутності.

І ось приходить Jumi кодер. Він кодує сценарії в такий спосіб, що Joomla! і його редактор не визнають це код. Однак Jumi плагін визнати Jumi синтаксис і всі між тегами Jumi.

{} Jumi stored_code_source цей простір між тегів для вашого письмового коду {/ jumi}

декодує і оцінює. Просто, чи не так?

Jumi кодер був протестований з nowysiwyg редактор Tiny MCE, JCE і FCK редакторів успішно. Що гарного в тому, що ви можете перемикатися між редакторами ні в редактори, як ви хочете. Jumi Coder не залежить від них.

Тому ще раз, як включати код до статті через Jumi кодер? Читайте і одночасно звернутися до зображення:

1. Запис (або скопіювати з деяких джерел) сценарію в області редактора коду.
   
2. Зрозумійте, якщо ви використовуєте Wysiwyg од Nowysiwyg редактора. Виберіть кодування відповідно.
3. Прес Encode.
4. Сценарій кодується, і ви отримаєте результат в закодованій області кодування коду. (Якщо ви зробили помилку або були закодовані для сценарію в іншому редакторі типу, просто натисніть Decode і повторити).
5. Виберіть скрипт, який ви бачите в області кодування код, скопіюйте його в буфер обміну (CTRL + C) і вставте його (Ctrl + V) в Joomla! і між фігурними теги Jumi.

Щоб бути впевненим, ви розумієте, давайте дивитися інше відео: як змінити скрипт, який вже знаходиться в Joomla! з Jumi Coder.

Ми сподіваємося, що це досить ясно.

Так що використовуйте Jumi Coder для вбудовування сценарію в Joomla! і для його редагування.

Jumi Coder може використовуватися для вбудовування сценарію коди в ваших не Joomla! блог теж (як блогер). Код не буде оброблятися, але буде включений як код.

Відома проблема: якщо сценарій "красиво", відформатованої (кілька рядків, вкладки і т.д.), то nowysiwyg редактор порушує цю форматування (без втрати зручності - вона буде працювати). I (MarHaj) не знають, як боротися з цим.

У редактори WYSIWYG добре зберігся.

Зрозуміло, що без Jumi плагін (встановлений і включений) сам сценарій не буде працювати! Jumi плагін для декодування в першу чергу. Пам'ятайте: Jumi Coder і Jumi плагін близнюки!

Синтаксис огляд

Загальна Jumi 2,1 плагін синтаксис

{} Jumi stored_code_source written_code {/ jumi}

де

• stored_code_source являє собою файл (PHP, CSS, JS, TXT, HTML, ...) шлях для включення в синтаксисі місце плагін або ідентифікатор (приступив зірочкою) пункту компонент Jumi і
• written_code це якийсь код. HTML, PHP, JS, OT тільки текст. Якщо PHP код, то він повинен бути обгорнутий в PHP початковий і кінцевий теги.
  

Приклади

Приклад 1: тільки включає в себе PHP-файл

{Jumi плагін / системи / jumi / jumi_demo.php} {/ jumi}

Приклад 2: у тому числі перший запис з Jumi таблиці бази даних компонентів

{Jumi * 1} {/ jumi}

Приклад 3: включає в себе перший запис з Jumi Компонент databes таблиці, яка передувати (!) Шляхом письмового сценарій.

{Jumi * 1} <PHP луна'Hello O \'Харрі';??> {/ Jumi}

Пріоритет обробки written_code -> stored_code_source має дві причини:

1. вона дозволяє використовувати попередньо 2,1 Jumi PHP файлів, які використовуються Jumi аргументи з Jumi 2,1 синтаксис (ми побачимо пізніше, як саме),
   
2. вона сумісна з іншими розширеннями Jumi (компонент, модулів): вони отримали такий самий обробці пріоритет.
   

Кілька рядків у писемності

Вам не потрібно писати написаний скрипт між тегами jumi в одну лінію. Кілька рядків. (І поєднання сценарію типу використовуються як добре). Наприклад:

{Jumi * 1}
<? PHP
  відлуння "Привіт O \ 'Харрі';
?>
<div>
  <script type="text/javascript"> language = "JavaScript"
    document.write ("Ваш улюблений напій <br />?");
    Функція завдяки () {
     window.alert ("Спасибі!")}
  </ SCRIPT>
  <form>
    <select name="qq">
      <option> води </ опції>
      <option> Молоко </ опції>
      <option> ведмідь </ опції> 
      <option> Інші </ опції>
     </ Виберіть>
    <input type="button" value="show" onClick="thanks()">
  </ FORM> 
<div>
{/ Jumi}

Тепер розберемося з Jumi плагін несумісності тому синтаксису.

Старий плагін Jumi синтаксис міграції

Старій - попередньо 2,1 Jumi - плагін використанням так званих Jumi аргументи концепції. Він може передати аргументи (деякі значення) у доданому файлі або не включені Jumi Компонент записи бази даних пункту.

У цьому випадку синтаксис був, як, наприклад, як цей:

{Jumi [myfile.php] [Едо] [888]}

Значення аргументів (в даному випадку кількість тексту "Едо" і номер 888) був доступний в PHP sript (myfile.php) через $ jumi [] масиву. Ось так:

<? PHP
  Відлуння $ jumi [0] $ jumi [1] "@ gmail.com" ..;
?>

Якщо ваші старі скрипти PHP використовує $ jumi [] масиву вам не потрібно їх сміття. Просто визначити $ jumi масиву в розділі written_code:

{Jumi myfile.php} <PHP $ jumi = Array ("Едо", 888);?> {/ Jumi}

І саме тому written_code обробляється до кодом, який зберігається.

Ми сподіваємося, ясно, і це дозволить перенести старі скрипти на 2,1 плагін синтаксису легко.

Якщо ви пишете скрипти з нуля можна визначити в written_code будь змінні, які можна використовувати в stored_code_source. Наприклад

{Jumi myfile.php}
<? PHP
  $ Ім'я = 'Едо';
  $ Номер = 888;
?>
{/ Jumi}

Пам'ятайте: будь-яка змінна, ви визначили поза функції або класу стає глобальною змінною. Це і добре і погано.

Це добре, тому що змінна не доступна з будь-якого місця. Це погано, тому що це може зв'язки зі змінною з тією ж назвою, який визначений (за іншими розробником) в іншому місці Joomla! сторінки.

Так що якщо ви використовуєте свій власний глобальні змінні, дати їм досить екзотичні імена.

Новий плагін Jumi питання безпеки

Якщо ви використовуєте Joomla! як відкрите середовище, це означає, що Є багато людей, які могли б сприяти змісту, питання безпеки є свої цінності.

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

Старі Jumi включає в себе тільки скрипти з файлу або з бази даних. Хакер може використовувати тільки ті, які були на вашому сайті (а він / вона повинен знати місце розташування). Але тепер, коли пряме включення сценарій можливий? Це ще один торт!

Joomla! розробники ввели чорний список і білий список фільтрації концепції в Joomla! 1.5.8. Ви можете запобігти тим, хто в чорний список або не на білий від певних "речі".

Jumi плагіна 2.1 використовує цей список. Якщо Автор статті (Або групи, до якої належить) знаходиться в чорному списку або знаходиться не на білий список, то Jumi плагін не оброблені код (відразу ж записати або не включені з файлу або бази даних) і код не буде видно У передній частині.

Joomla! itselfs видаляє код з статей. Jumi Coder, яка доступна кожному, хто в якості плагіна кнопку редактора буде включати в себе закодовані скрипт, який Joomla! не прибере. Тай код буде там. Але не буде оброблятися! Це не буде оброблятися навіть після Jumi плагін видалення - скрипт закодований ми повторюємо.

Так що якщо ваш білий / чорний список встановлений правильно, не відступаєте. Тільки будьте обережні.

Параметр "Jumi замовчуванням повний шлях", як ви знаєте, що з попередніх випусків все ще там. Тепер ми використовуємо трохи іншу назву: Jumi Root.

Jumi Коренева параметр дозволяє доступ скрипт файли легко withoyt письмовій повний шлях до них знову і знову. Ви можете розмістити свої файли сценаріїв поза Joomla! кореневої каталог.

Jumi Коренева був раніше створений кожного розширення Jumi самостійно. Тепер є тільки одне місце, де ви можете налаштувати його так: Jumi плагін. Установка дійсна для всіх розширення Jumi.

Так що це все поки

Ми, розробники, Едо мене (MarHaj), підтвердить будь зворотного зв'язку від вас, Jumi користувачів. Про себе або Jumi цієї документації. Что-то не вистачає? Щось неясно? Щось не працює, як очікувалося?

Дякуємо за ваш час в заздалегідь!

Jumi (prefarably позитивний) зворотних зв'язків

Все інше