Меню Рубрики

Установка плагина for xenforo

Начало работы

Эта документация предназначена для ознакомления вас с разработкой под XenForo 2.0. Предполагается, что перед началом работы с этой документацией вы уже знакомы с базовыми вещами, вроде PHP и MySQL. Опыт работы с предыдущими версиями XenForo не требуется, но предоставит ряд преимуществ.

На последующих страницах документации мы расскажем об установке локального сервера, подготовке к установке и самом процессе чистой установки XenForo 2.0 и объясним некоторые базовые концепции разработки под XF2.

Что нового для разработчиков?

Although XenForo 2.0 adds a lot of improvements for your forums and its members, a significant amount of effort has been put into improving the underlying framework of XenForo. You can read more information about these changes in the following threads:

Начало работы

Getting started with XF development is easy. You just need to download the files, upload them to a web server and trigger the install.

Если у вас еще нет веб-сервера, не беспокойтесь, вы легко сможете настроить его в локальном окружении.

Скачать XF 2.0

To download XF 2.0, just visit the Customer Area and log in as normal. Locate the correct license and click the «Download XenForo» link. Select the version you wish to download, the package type and accept the license agreement. Finally, click the Download button to download the files.

Системные требования XF 2.0

The requirements for running XF 2.0 have changed since XF 1.5. The recommended requirements are as follows:

  • PHP: 5.4.0+
  • MySQL: 5.5+
  • PHP extensions: MySQLi, GD (with JPEG support), PCRE, SPL, SimpleXML, DOM, JSON, iconv, ctype, cURL

Настройка локального сервера

It’s often more convenient to set up a local web server for development. There are generally two approaches for this:

  1. Install Apache (or nginx), MySQL (or MariaDB) and PHP yourself.
  2. Install a pre-built stack.

Setting things up yourself is more complicated, but tends to give you more control over how everything is set up.

A pre-built stack is the likely the easiest way to go. There are many of them out there and they may vary in feature set, performance and reliability. Bitnami maintain a number of stacks, including LAMP, «>MAMP and WAMP stacks for use on Linux, Mac and Windows respectively. They all include a fully configured installation of Apache, MySQL and PHP and include PhpMyAdmin for managing MySQL.


To install XF 2.0, you simply need to extract the ZIP file downloaded from the Customer Area and upload some of the files and directories within.

Once extracted you will see a directory named upload . You need to go into that directory and upload the files and directories to your server’s web root. This would usually be in a directory named public_html , htdocs or www .

Создание src/config.php

If using the CLI to install XF 2.0, you will need to create the config.php file manually. To do this, enter the src directory within the XF 2.0 files you uploaded to your server. Create a new file named config.php and populate it with the host, port, username, password and database name for your MySQL server.

Make sure you create the config file in within the src directory. The library directory is only used for legacy purposes.

Once finished, it should look like the following:

You’re now ready to install!

If you are using MySQL 5.5 and above and you wish to have full unicode support (for things like emoji) you should also add the following before install:

Замечание по правам доступа к файлам

XenForo will need to write files to specific locations while running. In normal operation, this is limited to the data and internal_data directories (and their sub-directories). These file writes will be triggered by things like attachment uploads, so they will normally be triggered by the user PHP as running as within your web server. Therefore, it is necessary to ensure that permissions are set in these directories so that the web server can write to them. You will need to do this before installation can begin.

When the CLI is involved, this situation gets trickier as there are now potentially two users that need to be able to write to the files. As such, it’s important to take steps to avoid problems writing to these files. Here are a few options.

  1. Use the same user for the CLI and the web server. This may take the form of you switching to the web server user before running any installation or upgrade command (or any other that will write files).
  2. If available, consider applying ACLs to the data and internal_data directories. This concept varies by OS and configuration, but the general idea is described here.
  3. Force specific permissions on what is written by PHP. This can be done via the src/config.php file with a line like this: $config[‘chmodWritableValue’] = 0666; This approach is potentially the simplest for development purposes.

Note that if you are developing add-ons, you may potentially have other locations that need to be written to by the CLI and web server users. Notably, this includes the _output directory within add-ons. In this situation, having your web server run as your CLI user may cause the least friction. If you go down any other route, you may need to ensure that your web server can write to your entire XenForo installation; this is not recommended in production.


The current way to install XF 2.0 is via the new CLI system. A lot of development processes can only be performed using the CLI so let’s get stuck into using it to install XF 2.0. To run these commands, you will need access to a terminal/shell, the php CLI command and the current working directory should be the root of where you uploaded the XF 2.0 files.

Читайте также:  Установка компенсации реактивной мощности 20квар

To eliminate file permission problems, we recommend running the installer as the same user that PHP runs as via your web server. If you don’t do this, you should take steps to ensure that permissions are set correctly. See the above section for more details.

To start the install, just enter the below command:

You will be asked a number of questions, such as the initial administrator username and password, board title. After this, the XF 2.0 database tables and master data will be imported.


Occasionally it may be necessary to reinstall XF2. This is particularly true during the Development Preview stage which does not support upgrading. If you are ready to do a reinstall, download the new files (if applicable) as per the Downloading XF 2.0 section above. It should generally be possible to just merge and overwrite your existing files. If you’re doing a full clean re-install, you may want to save a copy of your config.php file or re-create it as per the instructions in the Creating src/config.php.

Before uploading the new files, you should delete the contents of your data and internal_data directories.

Finally, you will just need to start the installation, similar to above. You will need to use the —clear option which will delete all of the existing xf_ tables.

$ php cmd.php xf:install —clear

Once the re-install has been completed, you should now be able to log back on.

If you have been developing add-ons, and you have chosen to keep or backup your existing src/addons directory, you can restore your add-on data with the Import development output command.

Be careful if you choose to back up and restore your src/addons directory. The XF directory within contains the XF master data, and should not be restored from a backup to ensure you always have the most up to date version of the files.

Performing a reinstall in this way is a destructive operation and it will remove all data you have created. Additionally, bear in mind that only tables with the xf_ prefix are cleared. This is a significant reason for the recommendation that all tables, even for add-ons, should be prefixed with xf_ .

Проверка целостности файлов

When you install XF2, we perform a file integrity check in the installation. If necessary, and you can’t otherwise perform the check via the page in the Admin CP, you can run the CLI command to perform that check.

$ php cmd.php xf:file-check [addon_id]

If you wish to do a file health check on all files, including XF itself, just omit the [addon_id] argument. For XF only, just use XF in place of the argument, or for a specific add-on, just specify the add-on ID you wish to check.

Команды управления плагинами

In addition to the above commands for installing XF2, there are also several commands for managing add-ons.

Установка плагина

$ php cmd.php xf:addon-install [addon_id]

Installs the specified add-on, as long as it is available, and passes the file health check. If development output is available, you will be asked to confirm if you wish to use that for the installation, instead of the exported data XML files.

Обновление плагина

$ php cmd.php xf:addon-upgrade [addon_id]

Upgrades the specified add-on, as long as it is upgradeable, and passes the file health check. Can optionally perform import from development output.

Пересборка плагина

$ php cmd.php xf:addon-rebuild [addon_id]

Rebuilds the master data for the specified add-on, as long as it is rebuildable, and passes the file health check. This re-imports the add-on’s data. Can optionally perform import from development output.

Удаление плагина

$ php cmd.php xf:addon-uninstall [addon_id]

Uninstalls the specified add-on, as long as it is uninstallable.

Сгенерировано при помощи MkDocs использующего тему theme предоставленную Read the Docs и модифицированную XenForo Ltd.


XenForo 2.1: Обновление в один клик и установка/обновление дополнений из ZIP-архивов


Добро пожаловать в предпоследний обзор нововведений в XF2.1.
Если Вы ещё не читали предыдущие обзоры, то рекомендуем почитать их здесь.

Обновление движка в один клик

Я уверен, что Вам не нужно, чтобы мы рассказывали Вам как делать обновления. Хотя мы всегда делали этот процесс максимально простым, неизбежно возникают некоторые общие жалобы на этот процесс. Независимо от того, являетесь ли вы новичком в веб сфере или опытным профессионалом, этот процесс может быть не исключает человеческую ошибку и помимо всего прочего, может отнимать много времени.

Зайти в кабинет пользователя (зайти к нам на форум ;D), скачать XenForo, открыть свой FTP-клиент, распаковать XenForo, загрузить файлы в корневой каталог форума, перейти на страницу установки, нажать на кнопку, чтобы начать обновление. Это слишком много действий.

Вышеупомянутый процесс, который состоит из загрузки, извлечения и копирования файлов — в основном все, кроме импорта данных, занимает около 30 секунд. Конечно, с различными факторами на стороне сервера, но независимо от того, как Вы его сокращаете, это будет быстрее, чем текущая процедура обновления.

Мы будем проверять новые обновления автоматически каждые 1-2 дня или Вы можете вручную проверить обновления с помощью Инструментов > Проверить наличие обновлений.

Но подождите . есть ещё больше нового!

Обновление официальны дополнений в один клик

Разумеется, новый подход с обновлений в один клик не будет полным, если не поддерживает аналогичную функциональность для XenForo Enhanced Search, Resource Manager and Media Gallery.

Читайте также:  Установка зажигания паз 32053

Конечно, у многих из Вас будет несколько дополнений XF, у некоторых из Вас даже есть все! Возможно, Вы уже догадались с начальной страницы подтверждения, что мы фактически поддерживаем установку нескольких дополнений XF одновременно!

Установка/обновление дополнений из ZIP-архивов

Вышеупомянутая новая возможность обновления официальных дополнений XF потребовала от нас наличия системы, которая позволяла бы загружать дополнительный архив (или архивы) из Вашего пользовательского кабинета, а затем позволяет распаковывать, копировать и в конечном итоге устанавливать их.

Итак, почему бы просто не позволить Вам загружать любой дополнительный архив и устанавливать/обновлять его таким образом? Почему бы не добавить несколько дополнений? Почему бы и нет =)

На странице «Дополнения» в админке появляется новая кнопка «Установить/обновить из архива». Хотя выше мы показали установку некоторых официальных дополнений XF, эта система позволит вам установить любое дополнение, просто загрузив дополнительный ZIP-архив или несколько ZIP-архивов.

Как только «Пакетная установка дополнений» закончится, Вы будете перенаправлены на итоговую страницу. Где Вам будет показано, были ли обнаружены ошибки во время процесса:

Подобно установке дополнений, Вы можете обновлять дополнения таким же образом. Вы также можете загрузить существующую версию, которую Вы уже установили, что приведет к «перестроению» дополнения. В этом контексте «перестройка» состоит из копирования с перезаписью существующих файлов и импорта всех данных дополнения (немного похоже на «Rebuild master data» у движка, но для дополнения).

Конфигурирование и требования

Что касается обновлений XenForo, по умолчанию мы будем автоматически проверять стабильные релизы/обновления (т. е. не бета-версии / RC), но если есть желание использовать раньше и принимать участие в тестировании — это Ваша задача, Вы можете включить получение нестабильных/предварительных обновлений в разделе Настройки > Основная информация. Конечно, это рекомендуется только на тестовых площадках, либо на которых была сделано резервное копирование (мы не несём ответственность создание Вами резервных копий, но как всегда предупреждаем, что их нужно делать).

Проверка обновлений для XF и официальных дополнений XF включена по умолчанию без какой-либо конфигурирования, поскольку они происходят из надежного источника. Однако у Вас могут быть причины отключить все обновления глобально одним кликом. Эти причины могут варьироваться от настроек безопасности на сервере, где установлены строгие запреты на доступ из вне и которые не позволяет получать нужные данные для работы механизма обновления.

Если Вы хотите отключить глобально все обновления, просто добавьте в файл src/config.php следующее:

Тем не менее, установка/обновления дополнений сторонних разработчиков происходит из загружаемых ZIP-архивов, что, возможно, не является тем, что Вы хотите отключать, а как раз наоборот использовать. Конечно же, применяются те же требования в отношении прав доступа к файлам. Таким образом, инсталлятор дополнений фактически отключен по умолчанию. Чтобы включить установку/обновление из архива, Вам нужно добавить в файл src/config.php следующее:

Чтобы сделать процесс как для обновлений XF, так и для дополнительных архивных установок максимально стабильным, а также для проверки работоспособности системы, чтобы гарантировать, что мы не столкнемся с ошибками во время процесса (которые могли бы привести Ваш форум и систему в нерабочее состояние), мы выполняем обширные проверки, чтобы гарантировать, что файлы/каталоги, которые должны быть созданы/перезаписаны, перезаписываются пользователем PHP. Далее мы делаем проверку с помощью обновления XF в один клик, чтобы убедиться, что PHP работает под тем пользователем, которому принадлежат файлы.

И, наконец, если это еще не ясно, Вам нужно будет убедиться, что PHP скомпилирован с поддержкой ZIP, что означает, что класс ZipArchive должен быть доступен.

Проверка лицензии и отчет об ошибках

Система обновления в один клик работает с использованием специального API (не связанной с нашим REST API), которая аутентифицируется специальным ключом API, который включен в Ваши архивы с XF 2.1. Одновременно с проверкой обновлений мы также проверяем несколько других вещей.

Пример некоторых ошибок и предупреждений, которые Вы можете видеть (но, надеюсь, не будете ), см. ниже:

Очевидно, что некоторые из этих предупреждений являются важными, и, кроме предупреждения об истечении срока действия лицензии (которое является чисто информационным), потенциально может указывать на нарушения лицензионного соглашения. Тем не менее, это в основном помогает избежать некоторых из существующих ошибок, которые клиенты иногда делают с помощью своих лицензий, таких как повторное использование одинаковых архивов на разных форумах, что противоречит лицензионному соглашению.

Вот и подошёл очередной обзор нововведений в XF2.1, но это ещё не всё и мы вернёмся с ещё одним на этой неделе. =)


FAQ — Часто задаваемые вопросы по XenForo

Лицензия, ее виды и методы оплаты



Переезд на другой сервер

Вопросы по внешнему виду и стилю форума

Общие вопросы

Лицензия, ее виды и методы оплаты

Q: Сколько стоит лицензия для XenForo?

A: Цена составляет $140 за одну лицензию. Лицензия пожизненная, плюс год можно качать бесплатно обновления. Продление возможности скачивать и дальше обновления будет стоить $40. В общем, все примерно как в старые добрые времена у vBulletin 3.

A: В первый день продажи лицензия стоила всего лишь $100. Новых акций со скидками пока не планируется.

Q: Есть ли оптовые скидки при покупке больше одной лицензии?

A: Да. С 15.03.2011 доступны следующие скидки:

— 1-2 лицензии: $140 за лицензию;
— 3-5 лицензий: $130 за лицензию;
— 6-10 лицензий: $120 за лицензию;
— больше 11 лицензий: $110 за лицензию.

Количество лицензий учитывается путем сложения покупаемых и тех, что уже есть (при этом имеющиеся лицензии должны быть активны).

Q: Какие методы оплаты доступны?

A: Купить можно через PayPal. Вероятно не исключены и другие методы оплаты, но для этого лучше связаться с разработчиками напрямую. (Русскоязычные пользователи, готовые приобрести лицензию за WebMoney, могут пройти в эту тему.)


Q: Каковы минимальные системные требования для XenForo?

Читайте также:  Установка кулера на печку

— PHP 5.2.11+
— MySQL 5.0+
— PHP расширения: MySQLi, GD (с поддержкой JPEG), PCRE, SPL, SimpleXML, DOM, JSON, iconv, ctype
— PHP safe_mode off

Настоятельно рекомендуется использовать PHP optcode хеш, например, APC или Zend Optimiser. XenForo воспользуется преимуществом этих систем и значительно улучшит производительность.

Чтобы проверить, соответствует ли ваш хостинг минимальным требованиям, скачайте этот скрипт и запустите его у себя на сайте.

A: Установка XenForo довольно проста:

— заливаем файлы на ftp;
— папки data и internal_data должны быть доступны для записи (chmod 0777);
— набираем в браузере адрес форума — скрипт автоматически перенаправит к процессу установки (если этого не произошло, наберите http://www.vash-sait.ru/forum/install/ );
— следуйте дальнейшим инструкциям, процесс установки может занять несколько минут.

Также рекомендуем ознакомиться с этим видео-уроком.

Q: Можно ли изменить префикс у таблиц в базе данных?

A: Нет. Префикс будет всегда xf_. Если нужно установить еще одну копию XenForo, создайте для нее новую базу данных.

A: Для установки плагинов (они же аддоны, дополнения, хаки) как правило необходимо:

— залить все файлы плагина в папку с форумом, соблюдая структуру всех подпапок.
— импортировать XML-файл плагина: Панель администратора » Вкладка Главная » Установить дополнение. Выбрать XML-файл и нажать кнопку Установить дополнение.
— некоторые плагины могут требовать изменений в шаблонах.
— также может потребоваться настройка прав для групп пользователей (например, если прав по умолчанию нет, то можно просто не увидеть какую-либо функцию плагина).
— и совсем редко некоторые плагины требуют непосредственного изменения в файлах XenForo. Но таких плагинов следует избегать, т.к. это лишние проблемы при последующем обновлении XenForo.

Важно! Всегда заливайте файлы, а потом уже производите импорт XML-файла! Иначе можете получить ошибку Пожалуйста, введите корректное имя метода обработчика.

Важно! Если структура папок отсутствует и непонятно, куда заливать, то пробуйте копировать все в папку library.

A: Для установки стилей (они же скины, темы оформления, «шкурки») как правило необходимо:

— залить файлы с графикой (в папку styles или же в подпапки).
— импортировать XML-файл стиля: Панель администратора » Вкладка Внешний вид » Импорт стиля. Выбрать XML-файл и нажиать кнопку Импорт.


A: Обновить XenForo так же просто, как и установить:

— заменяем все файлы на ftp от обновленной версии;
— переходим в браузере по адресу http://www.vash-sait.ru/forum/install/index.php?upgrade ;
— скрипт форума предложит авторизоваться;
— следуйте дальнейшим инструкциям, процесс обновления может занять несколько минут.

Также рекомендуем ознакомиться с этим видео-уроком.

На время обновления форум будет автоматически закрыт и откроется также самостоятельно после успешного завершения процесса.

Переезд на другой сервер

Q: Как перенести установленный XenForo на другой сервер?

A: Перенести XenForo очень просто. Для этого нужно:

— сделать копию базы данных и всех файлов со старого сервера;
— восстановить базу данных на новом сервере;
— залить все файлы на новый сервер;
— установить права для записи (chmod 0777) на папки data и internal_data и на все их содержимое;
— изменить данные для новой базы данных в файле library/config.php;
— если сменился не только сервер, но и адрес форума, то необходимо войти в панель администратора и сменить URL в основных настройках форума.

Вопросы по внешнему виду и стилю форума

Q: Как заменить стандартные иконки у разделов на свои?

Q: Как включить дополнительную информацию о пользователе в сообщениях под его аватаром?

Q: Почему появляется диалог подтверждения при нажатии на ссылке «Пометить все разделы как прочитанные»?

A: Одним кликом случайно можно наделать того, чего потом уже нельзя будет вернуть. Поэтому пользователю дается шанс убедиться, что он действительно хочет этого.

Q: Можно ли отключить все эффекты анимации в XenForo?

A: Можно. Это есть в настройках стиля.

Q: Можно ли отключить все те окна, которые открываются слоем поверх форума, так, чтобы они открывались просто следующей страницей?

A: Можно. Это есть в настройках стиля.

Q: Можно ли переключить описание разделов на классический вариант, чтобы они не отображались в виде всплывающей подсказки, а располагались ниже названия раздела?

A: Можно. Это есть в настройках стиля.
Панель администратора — Внешний вид — Настройки стиля — Список разделов/узлов
Отключить опцию Включить всплывающие подсказки с описаниями разделов форума

Общие вопросы

Q: Имеются ли для XenForo конвертеры с других форумов (vBulletin, IPB, phpBB и других)?

A: В XenForo 1.5+ встроены следующие конвертеры:
— IP.Board 3.1;
— IP.Board 3.2/3.3;
— IP.Board 3.4;
— IP.Board 4.0/4.1/4.2 (Beta);
— MyBB 1.6/1.8;
— phpBB 3.0.x;
— phpBB 3.1.x;
— phpBB 3.2.x (Beta);
— SMF 2.0;
— vBulletin 3.6;
— vBulletin 3.7/3.8;
— vBulletin 4.x;
— XenForo 1.2+.

Q: Планируется ли выпуск CMS, дневников и т.д. в дополнение к форуму?

A: На данный момент есть 3 официальных (платных) плагина — галерея, менеджер ресурсов и расширенный поиск (требует Elasticsearch 2.0).

Q: Как удалить личную переписку?

A: Кнопки удаления личной переписки нет. Если вы покинете личную переписку, то она исчезнет у вас из входящих. Если переписку покинут все ее участники, то она удаляется автоматически из базы данных.

Q: Почему внизу форума нет номера версии?

A: В XenForo версия форума будет отображаться только в панели администратора. Простому пользователю номер версии все равно ничего не скажет, а вот потенциальному взломщику будет трудней сопоставить версию и ее возможные уязвимости.

Q: Описание разделов теперь во всплывающих подсказках. Как это отразится на SEO?

A: Если отключить JavaScript и обновить список разделов главной страницы форума, то можно увидеть, что описание раздела находится там, где оно обычно располагается — сразу после названия раздела. JavaScript же срабатывает после завершения DOM модели, перемещая описания во всплывающую подсказку. Таким образом поисковые машины без проблем могут индексировать описания разделов.


Добавить комментарий