J3.x:Developing создание MVC компонента/разработка базовых компонент
From Joomla! Documentation
< J3.x:Developing an MVC Component
J3.x:Developing an MVC Component/ru == Примечания ==!Н!Этот учебник является частью Developing в создание MVC компонента для Joomla! 3.х: Учебное пособие. Вам рекомендуется прочитать предыдущие части учебника перед прочтением этой.
Если вы пользовались Joomla! перед чтением данного руководства вы заметили, что расширения устанавливаются, используя сжатый файл, содержащий все вещи, которые необходимы для установки и удаления.
Вы можете следовать ниже, чтобы создать компонент Hello World!, или вы можете напрямую загрузить архив
Вот несколько слайдов на основе этого документа, объясняющие, как создавать простые для продвижения компоненты на Joomla! .
!Н!в Joomla! Основная Справка Компонента
!Н!в Joomla! Продвинутая Справка Компонента
There are also a number of videos which accompany steps in the tutorial, beginning with
Step 1, Developing a Basic Component and you can access the slides which are used in the series of video presentations at Slides.
Important! Around version 3.8 the Joomla developers started changing the naming of Joomla classes and where they were stored in the directory structure. Many of the tutorial steps and videos refer to the old naming convention. To find the equivalent new class and where it's stored, look in your libraries/classmap.php file.
== Как добавить компонент на Joomla! ==!Н!В данной статье мы рассмотрим, как создать и установить базовый компонент на Joomla! . В этом примере мы будем работать с компонентом Hello World!.
Чтобы начать, вы должны сначала использовать нужный файл менеджер для создания каталога для компонента Hello World! . Этот каталог может быть где угодно в файловой системе, пока это за пределами вашего Joomla! директорию. В этом примере мы назовем каталоге com_helloworld, но эта директория может называться как угодно.
Далее внутри этого каталога нужно создать несколько файлов. Используя ваш любимый файловый менеджер, создайте следующие файлы; Добавьте исходный код для каждого файла, который находится в " файл подробности".
1 | helloworld.xml | это XML-файл (манифест) файл, который говорит Joomla! как установить наш компонент. |
2 | site/helloworld.php | это сайт точка входа для компонента Hello World! |
3 | site/index.html | предотвращает листинг из веб-сервера содержимого директории |
4 | admin/index.html | предотвращает листинг из веб-сервера содержимого директории |
5 | admin/helloworld.php | это точка входа администратора в компонент Hello World! |
6 | admin/sql/index.html | предотвращает листинг из веб-сервера содержимого директории |
7 | admin/sql/updates/index.html | предотвращает листинг из веб-сервера содержимого директории |
8 | admin/sql/updates/mysql/index.html | предотвращает листинг из веб-сервера содержимого директории |
9 | admin/sql/updates/mysql/0.0.1.sql | файл, позволяющий инициализировать версию схемы компонента com_helloworld. |
=== Установка Компонента Hello World! ===!Н!Используя ваш любимый файловый менеджер, создайте .zip файл из этого каталога. В данном примере мы будем использовать Имя файла com_helloworld.zipснова, хотя этот файл можно было назвать как угодно.
Теперь нам нужно установить компонент Hello World!. Есть два способа сделать это, оба показаны в Установке расширения. Здесь мы рассмотрим способ с использованием диспетчера расширений для Joomla!.
- Используя ваш любимый веб-браузер, перейдите в панель администратора вашего Joomla! сайт. Адрес, например, <yoursite>/joomla/administrator/index.php. Для этого примера мы будем ориентироваться на localhost/joomla/administrator/index.php.!Н!
- Выберите дополнительные модули Extensions → Manage → Install → Upload Package File → Choose File!Н!
- Перейдите и выберите файл!Н!
- Нажмите Кнопку " Загрузить & Установить
Примечание - Вы должны увидеть сообщение, показывающее, что установка выполнена успешно.
Вы можете протестировать основные функции компонента, введя Hello World! страницы для сайта и административной части вашего Joomla! сайта.!Н!
- Используя ваш любимый веб-браузер, перейдите к Hello World! компонент страницы, расположенной на части вашего сайта. Адрес бы <yoursite>/joomla/index.php?option=com_helloworld. Для этого примера мы будем ориентироваться на localhost/joomla/index.php?option=com_helloworld.!Н!
- Используя ваш любимый веб-браузер, перейдите к странице компонента Hello World!, расположенной в административной части вашего сайта. Адрес бы <yoursite>/joomla/administrator/index.php?option=com_helloworld. Для этого примера мы будем ориентироваться на localhost/joomla/index.php?option=com_helloworld.
Вы можете также заметить, что компонент Hello World! виден в административной части сайта после установки Joomla в подменю "компоненты".
Файл Детали
admin/sql/updates/mysql/0.0.1.sql файл, позволяющий инициализировать версию схемы компонента com_helloworld.
helloworld.xml
<?xml version="1.0" encoding="utf-8"?>
<extension type="component" version="3.0" method="upgrade">
<name>Hello World!</name>
<!-- The following elements are optional and free of formatting constraints -->
<creationDate>January 2018</creationDate>
<author>John Doe</author>
<authorEmail>[email protected]</authorEmail>
<authorUrl>http://www.example.org</authorUrl>
<copyright>Copyright Info</copyright>
<license>License Info</license>
<!-- The version string is recorded in the components table -->
<version>0.0.1</version>
<!-- The description is optional and defaults to the name -->
<description>Description of the Hello World component ...</description>
<update> <!-- Runs on update; New since J2.5 -->
<schemas>
<schemapath type="mysql">sql/updates/mysql</schemapath>
</schemas>
</update>
<!-- Site Main File Copy Section -->
<!-- Note the folder attribute: This attribute describes the folder
to copy FROM in the package to install therefore files copied
in this section are copied from /site/ in the package -->
<files folder="site">
<filename>index.html</filename>
<filename>helloworld.php</filename>
</files>
<administration>
<!-- Administration Menu Section -->
<menu link='index.php?option=com_helloworld'>Hello World!</menu>
<!-- Administration Main File Copy Section -->
<!-- Note the folder attribute: This attribute describes the folder
to copy FROM in the package to install therefore files copied
in this section are copied from /admin/ in the package -->
<files folder="admin">
<!-- Admin Main File Copy Section -->
<filename>index.html</filename>
<filename>helloworld.php</filename>
<!-- SQL files section -->
<folder>sql</folder>
</files>
</administration>
</extension>
site/helloworld.php
Hello World
admin/helloworld.php
Hello World administration
index.html
общее для всех папок
<html><body bgcolor="#FFFFFF"></body></html>
Содержание Компонента
В этот момент ваш компонент должен содержать следующие файлы:
1 | helloworld.xml | это XML-файл (манифест) файл, который говорит Joomla! как установить наш компонент. |
2 | site/helloworld.php | это сайт точка входа для компонента Hello World! |
3 | site/index.html | предотвращает листинг из веб-сервера содержимого директории |
4 | admin/index.html | предотвращает листинг из веб-сервера содержимого директории |
5 | admin/helloworld.php | это точка входа администратора в компонент Hello World! |
6 | admin/sql/index.html | предотвращает листинг из веб-сервера содержимого директории |
7 | admin/sql/updates/index.html | предотвращает листинг из веб-сервера содержимого директории |
8 | admin/sql/updates/mysql/index.html | предотвращает листинг из веб-сервера содержимого директории |
9 | admin/sql/updates/mysql/0.0.1.sql | файл, позволяющий инициализировать версию схемы компонента com_helloworld. |