torrentpier-lts/README.md

103 lines
9.3 KiB
Markdown
Raw Normal View History

2023-03-11 19:27:43 +03:00
![Logo](styles/images/logo/logo.png)
2023-04-08 09:51:01 +03:00
<hr>
TorrentPier II - движок торрент-трекера, написанный на php. Высокая скорость работы, простота модификации, устойчивость к высоким нагрузкам, в том числе и поддержка альтернативных анонсеров (например, Ocelot). Помимо этого, крайне развитый официальный форум поддержки, где помимо прочего можно испытать движок в работе на демо-версии, не устанавливая его, а также получить любую другую интересующую вас информацию и скачать моды.
2023-10-08 15:50:25 +03:00
Основа для LTS версии: [v2.1.5-ALPHA5](https://github.com/torrentpier/torrentpier/releases/tag/v2.1.5).
2023-04-08 09:51:01 +03:00
<hr>
2023-04-01 10:00:07 +03:00
> Подробнее про LTS версию: https://torrentpier.com/threads/predstavlenie-torrentpier-lts.42114/
2023-10-14 07:19:30 +03:00
> Список изменений: [CHANGELOG.md](https://github.com/torrentpier/torrentpier-lts/blob/main/CHANGELOG.md)
2023-03-11 19:27:43 +03:00
2023-06-24 07:14:49 +03:00
## 🚧️ Предупреждение
2023-04-05 20:26:46 +03:00
Настоятельно рекомендуется использовать движок со стандартным шаблоном, поскольку в tpl файлах тоже есть фиксы, которых может не быть в готовых шаблонах (сторонних). В любом случае вы можете интегрировать нужные исправления самостоятельно в сторонний шаблон. Для этого нужно воспользоваться историей коммитов папки [templates](https://github.com/torrentpier/torrentpier-lts/commits/main/styles/templates).
2023-06-24 07:28:07 +03:00
<br><br><i>P.S. - Историю коммитов нужно смотреть с самого начала (снизу).</i>
2023-04-05 20:26:46 +03:00
2023-06-24 07:14:49 +03:00
## 💾 Установка
Для установки вам необходимо выполнить несколько простых шагов:
1. Распаковываем на сервер содержимое скачанной вами папки
2. Создаем базу данных, в которую при помощи phpmyadmin (или любого другого удобного инструмента) импортируем дамп, расположенный в папке **install/sql/mysql.sql**
3. Правим файл конфигурации **library/config.php**, загруженный на сервер:
2023-06-16 18:34:07 +03:00
* ***'db1' => array('localhost:3306', 'tp_215_lts', 'user', 'pass', $charset, $pconnect)***
2023-04-17 19:09:00 +03:00
<br>В данной строке изменяем данные входа в базу данных.
* ***$domain_name = 'torrentpier.com';***
<br>В данной строке указываем ваше доменное имя. Остальные правки в файле вносятся по усмотрению, исходя из необходимости из внесения (ориентируйтесь на описания, указанные у полей).
* ***$domain_ssl = false;***
<br>В данной строке ставим значение true, если имеется SSL сертификат (HTTPS). При значении false (По умолчанию) скрипт сам определяет наличие SSL сертификата.
4. Редактируем указанные файлы:
2023-09-23 09:24:12 +03:00
+ **favicon.ico** (меняем на свою иконку, если есть)
+ **robots.txt** (меняем адреса в строках **Host** и **Sitemap** на свои)
+ **opensearch_desc.xml** (меняем описание и адрес на свои)
+ **opensearch_desc_bt.xml** (меняем описание и адрес на свои)
2023-06-24 07:14:49 +03:00
## 🔑 Права доступа на папки и файлы
Исходя из настроек вашего сервера, устанавливаем рекомендуемые права доступа (chmod) на указанные папки **777**, а на файлы внутри этих папок (кроме файлов **.htaccess** и **.keep**) **666**:
- data/avatars
- data/old_files
2023-09-23 09:36:52 +03:00
- data/old_files/thumbs
- data/torrent_files
- internal_data/ajax_html
- internal_data/atom
- internal_data/cache
- internal_data/log
- internal_data/sitemap
- internal_data/triggers
2023-06-24 07:14:49 +03:00
## ⚓️ Необходимая версия php
2023-10-12 10:51:49 +03:00
Минимально поддерживаемой версией PHP в настоящий момент является **5.3.4**. Существует поддержка вплоть до **5.6** последних версий. Поддержка PHP 7 отсутствует.
2023-06-24 07:14:49 +03:00
## ⚓️ Необходимые настройки php
2023-10-22 14:54:48 +03:00
mbstring.internal_encoding = UTF-8
magic_quotes_gpc = Off
Внести данные настройки необходимо в файл **php.ini**. Их вам может установить ваш хостер по запросу, если у вас возникают какие-либо проблемы с их самостоятельной установкой. Впрочем, эти настройки могут быть установлены на сервере по-умолчанию, поэтому их внесение требуется исключительно по необходимости.
2023-06-24 07:14:49 +03:00
## ⚓️ Необходимые модули php
2023-10-22 14:54:48 +03:00
php5-tidy
2023-09-23 09:34:56 +03:00
mbstring
bcmath
intl
2023-09-25 19:15:58 +03:00
mysql
2023-09-23 09:44:34 +03:00
Начиная с версии **2.0.9** (**ревизия 592** в старой нумерации) модуль **php5-tidy** не является обязательным, но его установка крайне рекомендуется для повышения качества обработки html-кода тем и сообщений пользователей.
2023-06-24 07:14:49 +03:00
## ⚓️ Рекомендуемый способ запуска cron.php
2023-03-11 19:19:15 +03:00
Для значительного ускорения работы трекера может потребоваться отвязка встроенного форумного крона. С более подробной информацией об отвязке крона, вы можете ознакомиться в данной теме https://torrentpier.com/threads/52/ на нашем форуме поддержки.
2023-06-24 07:14:49 +03:00
## ⚓️ Локальный файл конфигурации
2023-09-23 09:44:34 +03:00
Начиная с **ревизии 599** была добавлена поддержка автоматического подключения файла **config.local.php**, при создании его вами. Данный файл является заменой **config.php** для конкретного сервера, на котором запущен трекер. (При создании **config.local.php** он будет загружаться вместо **config.php**)
2023-09-23 09:40:21 +03:00
## ⚓️ Файл конфигурации для модов
2023-09-23 09:44:34 +03:00
Начиная с версии **v2.1.5-2023.09** была добавлена автоматическая загрузка настроек для модификаций из файла **config.mods.php**. Данный файл уже присутствует по умолчанию, при желании его можно удалить. Настройки для модификаций лучше указывать именно в нем, вместо того чтобы писать их в **config.php**. Это сделано для удобства, чтобы отделить настройки движка и настройки модов.
2023-09-23 09:40:21 +03:00
2023-06-24 07:14:49 +03:00
## ⚓️ Установка Ocelot
2023-09-23 09:27:26 +03:00
В движок встроена по-умолчанию поддержка альтернативного компилируемого анонсера - Ocelot. Настройка производится в файле **library/config.php**, сам анонсер находится в репозитории: https://github.com/torrentpier/ocelot
2023-03-11 19:19:15 +03:00
Инструкция по сборке приведена на нашем форуме: https://torrentpier.com/threads/sborka-ocelot-pod-debian-7-1.26078/
Для работы анонсера требуется замена двух таблиц в базе данных - дамп в файле: **install/sql/ocelot.sql**
2023-06-24 07:14:49 +03:00
## ⚓️ Папка install
2023-09-23 09:25:50 +03:00
В корне движка присутствует папка **install**, в которой находятся служебные файлы, необходимые для его установки (дамп базы, примеры конфигов) и обновления (дамперы, скрипты конвертации). Доступ к данной папке по-умолчанию закрыт, но если ее присутствие вам мешает - вы можете ее удалить. На файлы **README.md**, **.git**, **.github**, **.gitignore**, **CHANGELOG.md**, **CODE_OF_CONDUCT.md** и **CONTRIBUTORS.md** это также распространяется.
2023-06-24 07:14:49 +03:00
## 📌 Полезные ссылки
2023-03-11 19:19:15 +03:00
+ Наш форум https://torrentpier.com/
+ Центр загрузки https://get.torrentpier.com/
+ Часто задаваемые вопросы https://faq.torrentpier.com/
+ Где задать вопрос https://torrentpier.com/forums/10/