VlabEmbed - це експериментальний фільтр для Moodle 2. Він надає можливість убудовувати у сторінки курсів Moodle віртуальну хімічну лабораторію ChemCollective Virtual Lab, використовуючи аплет VLab.

Для роботи віртуальна лабораторія VLab потребує декілька файлів даних, переважно із розширенням .xml. Один із таких файлів містить посилання на всі інші і вважається головним файлом. Сутність роботи фільтру VlabEmbed полягає у заміні посилання на відповідний головний xml-файл на аплет, у якому запускається віртуальна лабораторія VLab.

Для цього посилання на файл віртуальної лабораторної роботи із розширенням ".xml" або будь-який текст із відповідним гіперпосиланням має бути включено у тексті у блок [vlab]...[/vlab].

Для установки плагіна необхідно виконати такі дії:

1. Завантажте архів з плагіном на локальний комп'ютер за посиланням https://moodle.org/plugins/view/filter_vlabembed.

2. Увійдіть до Moodle з правами адміністратора, перейдіть до Керування сайтом | Модулі | Встановлення модулів.

3. У встановлювачі модулів Виберіть файл... із завантаженим архівом плагіну та натисність Встановити модуль із ZIP пакету.

4. Перейдіть до Керування сайтом | Модулі | Фільтри | Управління фільтрами.

3. Виберіть Увімкнуто або Вимкнуто, але доступно у  меню, що випадає, навпроти "VlabEmbed".

4. Налаштуйте зручні для себе параметри плагіна: ширину і висоту вікна аплета та мову із меню, що випадає.

5. Через розбіжності у ліцензіях файли аплету, що необхідні для роботи віртуальної лабораторії, не включені до пакету фільтру VlabEmbed. Але їх можна завантажити із зовнішніх джерел за допомогою вбудованого завантажувача, обравши посилання "Спробувати автоматично завантажити файли аплету Vlab із вказаних джерел або сайту ChemCollective".

Також Ви можете уточнити шляхи (зовнішні посилання), звідки будуть завантажені файли віртуальної лабораторії, у вікні редагування. Якщо жоден із вказаних шляхів не виявиться правильним, відбудеться спроба завантажити мінімальний набір файлів віртуальної лабораторії, необхідних для її функціонування, із сайту розробника VLab. Якщо і це не вдасться - завітайте до сайту ChemCollective, завантажте із нього архів Virtual Lab for offline use (наприклад, міжнародну версію для Windows) та зверніться до адміністратора для того, щоб він розташував файли з архіву у каталозі фільтру (зазвичай за шляхом: шлях_до_moodle_на_сервері/filter/vlabemebed) за інструкцією, наведеною у п. 5 файлу https://raw.githubusercontent.com/ssemerikov/moodle-filter_vlabembed/master/README.md.

Віртуальна лабораторія, що знаходиться на сайті розробника, супроводжується репозиторієм із завданнями різними мовами (у тому числі українською - http://chemcollective.org/activities/vlab?lang=uk), а також доступ до онлайн репозиторію англійською. Але на сторінці свого курсу Ви можете розмістити будь-яку окрему роботу із локального репозиторію, який може бути завантажено на сайт при налаштуванні фільтру за одним із трьох посилань за замовчанням, або з архіву Virtual Lab for offline use.

Нижче розміщено приклад роботи фільтру VlabEmbed: віртуальна лабораторія, яка є ознайомчою покроковою демонстрацією основних можливостей Virtual Lab. Якщо файл Walkthrough.xml, необхідний для запуску саме цієї роботи, знаходиться у локальному репозиторії сайту, посилання, що оброблятиметься фільтром, для даного сайту буде таким: http://ict-chem.ccjournals.eu/filter/vlabembed/assignments/problems_uk/Walkthrough.xml (поточні налаштування фільтру: ширина вікна аплета - 800, висота вікна аплета - 600, мова локалізації - українська).

Запуск віртуальної лабораторної роботи відбувається лише за наявності головного xml-файлу та набору файлів за відповідним шляхом.

Запустити віртуальну лабораторну роботу можна кількома способами:

1) У блок [vlab]...[/vlab] вставити посилання виду http://адреса_Вашого _сайту_з_moodle/шлях_до_головного_файлу.xml

2) Завантажити окрему роботу, що міститься у каталозі vlabembed, обравши необхідні для її запуску файли з переліку, наведеному нижче у пункті 4.

3) Створити окремий каталог на сайті і завантажити необхідні файли із зовнішнього ресурсу.

4) Завантажити необхідні файли із зовнішнього ресурсу і вивантажити їх у спеціально створений каталог у межах курсу або прикріпити їх до документу, а потім вставити посилання на потрібний головний файл .xml у блок [vlab]...[/vlab].

Завантажений архів vlab_ukr.zip (за посиланнями, що є у налаштуваннях фільтру) або vlab.2.1.0.int.zip (із сайту розробника) мають ідентичний набір робіт, що розташовані у каталозі архіву також ідентично.

У таблиці наведено перелік файлів та віртуальних лабораторних робіт, для яких вони необхідні.

Назва роботи	Автори	Короткий опис роботи	Необхідні файли	Шлях до файлів
Стандартна віртуальна лабораторія	Майк Карабінос	Містить речовини та розчини стандартної препараторської віртуальної лабораторії та реакції між ними.	Default_uk.xml /default_uk/	assignments/Default_uk.xml assignments/default_uk/
Покрокова демонстрація	Емма Рем	Детальний вступний інструктаж з деяких найбільш часто вживаних функцій Virtual Lab.	Walkthrough.xml /walkthrough/	assignments/problems_uk/Walkthrough.xml assignments/problems_uk/walkthrough/
Густина і питома темплоємність	Жорді Куадрос	Просто поекспериментуйте із густиною і теплоємністю.	DandSH.xml /dandsh/	assignments/problems_uk/DandSH.xml assignments/problems_uk/dandSH/
Задача про розбавлення 1	Дейв Ярон	Приготуйте розчин глюкози розбавленням концентрованого її розчину.	Dilution.xml /dilution/	assignments/problems_uk/molarity/Dilution.xml assignments/problems_uk/molarity/dilution/
Задача про розбавлення 2	Майк Карабінос	Приготування розчину розбавленням концентрованої кислоти.	Dilution2.xml /dilution2/	assignments/problems_uk/molarity/Dilution2.xml assignments/problems_uk/molarity/dilution2/
Задача про розчин цукрози	Жорді Куадрос та Тім Палука	Для розуміння концентрацій: молярної, моляльної, масової частки та молярної частки.	Concentration1.xml /concentration1/	assignments/problems_uk/molarity/Concentration1.xml assignments/problems_uk/molarity/concentration1/l
Приготування розчинів з кристалічних сполук	Жорді Куадрос та Майк Карабінос	Приготування розчинів солі різної концентрації.	Molarsoln.xml /molarsoln/	assignments/problems_uk/molarity/Molarsoln.xml assignments/problems_uk/molarity/molarsoln/
Задача про густину металів	Жорді Куадрос та Тім Палука	Ідентифікація металів за їх густиною.	Metals.xml /metals/	assignments/problems_uk/molarity/Metals.xml assignments/problems_uk/molarity/metals/
Задача про густину рідини	Жорді Куадрос та Тім Палука	Ідентифікація рідин за їх густиною.	LiquidDensity.xml /liquiddens/	assignments/problems_uk/molarity/LiquidDensity.xml assignments/problems_uk/molarity/liquiddens/
Задача про густину спирту	Жорді Куадрос та Тім Палука	Визначення концентрації за густиною розчину.	Alcohol.xml /alcohol/	assignments/problems_uk/molarity/Alcohol.xml assignments/problems_uk/molarity/alcohol/
Різнобарвна задача	Донован Ленг	У цьому завданні студентам треба змішувати розчин разом, спробувавши контролювати зміну їх кольору.	Jello.xml /jello/	assignments/problems_uk/stoichiometry/Jello.xml assignments/problems_uk/stoichiometry/jello/
Загадка Оракула	Донован Ленг	Завдання про лімітуючий реагент для визначення стехіометрії реакції.	Oracle2.xml /oracle2/	assignments/problems_uk/stoichiometry/Oracle2.xml assignments/problems_uk/stoichiometry/oracle2/
Загадка Оракула 2	Донован Ленг	Завдання про лімітуючий реагент та стехіометрію у складній суміші.	Oracle.xml /oracle/	assignments/problems_uk/stoichiometry/Oracle.xml assignments/problems_uk/stoichiometry/oracle/
Завдання про надлишок реагенту 1	Девід Ярон та Майк Карабінос	Збірник практичних вправ на лімітуючі реагенти з використанням віртуальної лабораторії.	Hslimit1.xml /hslimit1/	assignments/problems_uk/stoichiometry/Hslimit1.xml assignments/problems_uk/stoichiometry/hslimit1/
Завдання про співвідношення реагентів	Девід Ярон	Проведіть експеримент, щоб отримати відповідь на задачу про лімітуючий реагент.	Hslimit2.xml /hslimit2/	assignments/problems_uk/stoichiometry/Hslimit2.xml assignments/problems_uk/stoichiometry/hslimit2/
Прогнозування концентрації ДНК	Девід Ярон	Спрогнозуйте лімітуючий реагент у завданні, пов'язаному з нитками ДНК.	Dnabind.xml /Dnabind/	assignments/problems_uk/stoichiometry/Dnabind.xml assignments/problems_uk/stoichiometry/dnabind/
Забарвлення ДНК 2	Девід Ярон	У цій вправі на лімітуючий реагент, учні освоюють експеримент із визначення немічених молекул.	DnaDye2.xml /dnadye2/	assignments/problems_uk/quant/DnaDye2.xml assignments/problems_uk/quant/dnadye2/
Задача на встановлення концентрації	Майк Карабінос	Визначення концентрації йонів Аргентуму у розчині аргентум нітрату.	Silver.xml /silver/	assignments/problems_uk/quant/Silver.xml assignments/problems_uk/quant/silver/
Гравіметричне визначення Арсену	Жорді Куадрос	Визначення вмісту сполук Арсену у пробі грунту.	ArsGrav.xml /arsgrav/	assignments/problems_uk/quant/ArsGrav.xml assignments/problems_uk/quant/arsgrav/
Досліди зі сполуками Кобальту	Боб Белфорд	У експерименті на прикладі комплексних сполук Кобальту (II) розглядається принцип & Ле-Шательє.	Cobalt.xml /cobalt/	assignments/problems_uk/equilibrium/Cobalt.xml assignments/problems_uk/equilibrium/cobalt/
Задача на утворення ДНК	Дейв Ярон	Дослідження констант рівноваги у біохімічних системах.	Dnabind.xml /dnabind/	assignments/problems_uk/equilibrium/Dnabind.xml assignments/problems_uk/equilibrium/dnabind/
Температура і розчинність солей	Роб Белфорд та Девід Ярон	Дослідіть залежність розчинності солей у воді від температури.	Sol.xml /sol/	assignments/problems_uk/solubility/Sol.xml assignments/problems_uk/solubility/sol/
Визначення добутків розчинності	Роб Белфорд та Девід Ярон	Визначення константи (добутку) розчинності Ks (ДР) для різних солей.	Sol2.xml /sol2/	assignments/problems_uk/solubility/Sol2.xml assignments/problems_uk/solubility/sol2/
Задача на визначення розчинності	Дейв Ярон	Визначення розчинності CuCl за різних температур.	CuClSolu.xml /cuclsolu/	assignments/problems_uk/solubility/CuClSolu.xml assignments/problems_uk/solubility/cuclsolu/
Термохімічне завдання 1	Дейв Ярон	Дослідити і визначити тепловий ефект реакцій у водних розчинах.	Thermo.xml /thermo/	assignments/problems_uk/thermochemistry/Thermo.xml assignments/problems_uk/thermochemistry/thermo/
Завдання про приготування кави	Тім Палука та Девід Ярон	Приготуйте каву із заданою температурою.	Coffee.xml /сoffee/	assignments/problems_uk/thermochemistry/Coffee.xml assignments/problems_uk/thermochemistry/coffee/
Теплота реакції - Закон Гесса	Barry Charington	Демонстрація закону Гесса використовуючи три реакції: розчинення NaOH у воді і хлоридній кислоті, та реакція розчину HCl та NaOH між собою.	Heatrxn.xml /heatrxn/	assignments/problems_uk/thermochemistry/Heatrxn.xml assignments/problems_uk/thermochemistry/heatrxn/l
Охолоджувач I	Тім Палука і Жорді Куадрос	Визначте і порівняйте теплоємність невідомої рідини.	Freeze.xml /freeze/	assignments/problems_uk/thermochemistry/Freeze.xml assignments/problems_uk/thermochemistry/freeze/
Охолоджувач II	Тім Палука і Девід Ярон	Необхідно визначити питому теплоємність невідомої рідини з невідомою густиною.	Freeze2.xml /freeze2/	assignments/problems_uk/thermochemistry/Freeze2.xml assignments/problems_uk/thermochemistry/freeze2/
Термохімія у турпоході 1	Тім Палука і Дейв Ярон	Визначте ентальпію хімічної реакції, що допоможе Вам вирішити проблему в турпоході.	ThermoQ1.xml /thermoQ1/	assignments/problems_uk/thermochemistry/ThermoQ1.xml assignments/problems_uk/thermochemistry/thermoQ1/
Термохімія у турпоході 2	Тім Палука і Девід Ярон	Визначте залежність кількості теплоти, що виділяється під час реакції між різними об'ємами розчинів різних концентрацій.	ThermoQ2.xml /thermoQ2/	assignments/problems_uk/thermochemistry/ThermoQ2.xml assignments/problems_uk/thermochemistry/thermoQ2/
Термохімія у турпоході 3	Девід Ярон і Жорді Куадрос	Змішуйте розчини з таким розрахунком, щоб отримати суміш із заданою температурою.	ThermoQ3.xml /thermoQ3/	assignments/problems_uk/thermochemistry/ThermoQ3.xml assignments/problems_uk/thermochemistry/thermoQ3/
Реакція з АТФ (Термохімія та хімічні зв'язки)	Девід Ярон і Жорді Куадрос	Визначення ентальпії реакції гідролізу АТФ та міцності хімічних зв'язків у молекулі АТФ.	Atp.xml /atp/	assignments/problems_uk/thermochemistry/Atp.xml assignments/problems_uk/thermochemistry/atp/
Завдання про сильну кислоту	Ріа Фріленд	Добірка завдань про сильні кислоти та основи, що можуть бути вирішені за допомогою віртуальної лабораторії.	StrongAcid.xml /strongacid/	assignments/problems_uk/acidbase/StrongAcid.xml assignments/problems_uk/acidbase/strongacid/
Завдання про слабку кислоту	Ріа Фріленд	Добірка завдань про слабкі кислоти та основи, що можуть бути вирішені за допомогою віртуальної лабораторії.	WeakAcid.xml /weakacid/	assignments/problems_uk/acidbase/WeakAcid.xml assignments/problems_uk/acidbase/weakacid/
Метод послідовних розведень	Боб Белфорд	Дослідити шкалу pH методом послідовних розведень.	Dilut.xml /dilut/	assignments/problems_uk/acidbase/Dilut.xml assignments/problems_uk/acidbase/dilut/
Кислотно-основне титрування	Софія Нуссбаум	Набір завдань і вправ для підготовки до проведення кислотно-основного титрування.	PrelabAcid.xml /prelabAcid/	assignments/problems_uk/acidbase/PrelabAcid.xml assignments/problems_uk/acidbase/prelabAcid/
Cтандартизація розчину NaOH	Дейв Ярон	Робота для попередньої підготовки до стандартизації розчину NaOH за розчином калій гідрогенфталату.	Titration.xml /titration/	assignments/problems_uk/acidbase/Titration.xml assignments/problems_uk/acidbase/titration/
Завдання про невідомі кислоти і основи	Дейв Ярон	У цій вправі учні повинні за кривою кислотно-основного титрування визначити pKa невідомої кислоти та її концентрацію.	Unknownacid.xml /unknownacid/	assignments/problems_uk/acidbase/Unknownacid.xml assignments/problems_uk/acidbase/unknownacid/
Завдання про pKa слабких кислот	Дейв Ярон	Визначення взаємовідношення між pKa та концентрацією білка у розчині.	Buffer.xml /buffer/	assignments/problems_uk/acidbase/Buffer.xml assignments/problems_uk/acidbase/buffer/
Завдання на створення буферного розчину	Софія Нуссбаум	Вправи для створення буферних розчинів з певними властивостями.	MkBuffer.xml /mkbuffer/	assignments/problems_uk/acidbase/MkBuffer.xml assignments/problems_uk/acidbase/mkbuffer/
Завдання про забарвлення ДНК	Дейв Ярон	Студенти вивчають рівноваги у буферних розчинах та їх застосування у біологічних дослідженнях.	Dnadye.xml /dnadye/	assignments/problems_uk/acidbase/Dnadye.xml assignments/problems_uk/acidbase/dnadye/
Ряд окисно-відновних реакцій	Баррі Чарінгтон	Студенти готуються до вивчення окисно-відновних реакцій за експериментальними даними, отриманими у віртуальній лабораторії.	Redox.xml /redox/	assignments/problems_uk/redox/Redox.xml assignments/problems_uk/redox/redox/

Просимо залишати Ваші відгуки на відповідному форумі.

VlabEmbed

=============

A Moodle filter plug-in to embed ChemCollective Virtual Lab problems using the Vlab Java applet.
It embeds any assigments (both local and global).

NOTICE: this software is in no way endorsed by or affiliated with the official ChemCollective project or team.

 *  This filter will replace links to a Vlab file (.xml) in [vlab]...[/vlab] block
 *  with a java applet that plays that ChemCollective Virtual Lab inline


Installation
------------
To install (on Moodle 2):

1. Un-compress the Zip/Gzip archive, and copy the folder renamed 'vlabembed' to your moodle/filter/ directory.

2. Log in to Moodle as admininstrator, go to Site Administration | Plugins | Filters | Manage Filters.

3. Choose 'On' or 'Off but available' in the drop-down menu next to 'VlabEmbed'.

4. Configure plugin width, height, language (available codes: BR - Brasilian Portugese, CA - Catala, DE - Deutsch, ES - Espanol, FR - Francais, GR - Greek, RU - Russian, UK - Ukrainian) and Vlab files autodownload facilities.

5. Vlab files external sources are need to filter's work: by default, Virtual Lab applet files are not included into VlabEmbed filter package due to it license (CC BY-NC-ND 3.0) is not compatible with the GNU GPLv3. So you can install Vlab files via vlabinstaller.php.

   You can also manually download archive of Vlab applet files from http://ict-chem.ccjournals.eu/vlab_ukr.zip, http://kdpu.edu.ua/download/kaf_chem/books/vlab_ukr.zip or https://sites.google.com/site/kafedrahimiie/necipurenko-p/chemistry-virtual-lab-ukrainian-version/ukraienskaversiavirtuallab/vlab_ukr.zip and extract them into filter directory (yoursitemoodledirectory/filter/vlabembed) or download it separately from ChemCollective site.

Usage
-----
The syntax to embed a project:

    [vlab]...[/vlab]

... = link or hyperlink to a file with the extension ".xml" of the laboratory work.

Example of filter VlabEmbed: virtual laboratory, which is a step by step demonstration of a study of the main features Virtual Lab. File Walkthrough.xml, it is necessary to start this work is in the local repository site, so links the treated filter: http://ict-chem.ccjournals.eu/filter/vlabembed/assignments/Walkthrough.xml. Setting filter width window applet = 800, height = 600, language localization - English.

[vlab][/vlab]   https://ict-chem.ccjournals.eu/pluginfile.php/61/mod_page/content/56/walkthrough_uk/Walkthrough.xml

Links
-----
* Moodle plugin entry: <http://moodle.org/plugins/view.php?plugin=filter_vlabembed>
* Code, Git: <https://github.com/ssemerikov/moodle-filter_vlabembed>
* Demo : <http://ict-chem.ccjournals.eu>
* "Why square brackets?", <http://bitbucket.org/nfreear/timelinewidget/src/tip/filter.php#cl-36>

Notes
-----
* Tested in Moodle 2.8.5.
* No javascript, no database access - very simple!
* Filter syntax is case-sensitive.
* The plug-in is internationalized in Moodle 2 in Deutsch, Russian, and Ukrainian.

Notices
-------
VlabEmbed plugin, Copyright (c) 2015 2015 Pavlo Nechipurenko, Sergey Semerikov.

* License: <http://www.gnu.org/copyleft/gpl.html> GNU GPL v3 or later.

The Chemistry Collective project Virtual Lab 1.6.4, Copyright (c) 1999-2010 Dave Yaron

* License: <http://chemcollective.org/help/copyright>