torrentpier/torrentpier-lts

🐇 TorrentPier. LTS project repository

TorrentPier II - движок торрент-трекера, написанный на php. Высокая скорость работы, простота модификации, устойчивость к высоким нагрузкам, в том числе и поддержка альтернативных анонсеров (например, Ocelot). Помимо этого, крайне развитый официальный форум поддержки, где помимо прочего можно испытать движок в работе на демо-версии, не устанавливая его, а также получить любую другую интересующую вас информацию и скачать моды.

Основа для LTS версии: v2.1.5-ALPHA5.

---

Подробнее про LTS версию

Список интегрированных модов в LTS версию

Список изменений: CHANGELOG.md

🚧️ Предупреждение

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

P.S. - Историю коммитов нужно смотреть с самого начала (снизу).

💾 Установка

Для установки вам необходимо выполнить несколько простых шагов:

1. Распаковываем на сервер содержимое скачанной вами папки
2. Создаем базу данных, после импортируем дамп, расположенный в install/sql/mysql.sql
3. Правим файл конфигурации library/config.php, загруженный на сервер:
   1. 'db1' => array('localhost:3306', 'tp_215_lts', 'user', 'pass', $charset, $pconnect),
   2. $domain_name = 'torrentpier.com';
   3. $domain_ssl = false;
4. Редактируем эти файлы:
   1. favicon.png (измените на свою)
   2. robots.txt (измените адреса в строках Host и Sitemap на свои)
   3. opensearch_desc.xml (измените описание и адрес на свои)
   4. opensearch_desc_bt.xml (измените описание и адрес на свои)
5. Войдите на форум под логином/паролем - admin/admin и завершите настройку через админ-панель

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

Обновление движка с R400 до 2.1 (R600)

• Если у вас установлена версия движка ниже чем 2.1 (R600), то воспользуйтесь инструкцией из этой статьи, данная инструкция поможет обновить движок до состояния 2.1 (R600), что позволит приступить к следующему шагу в обновлении движка уже с 2.1 (R600) до 2.1.5-LTS последней ревизии.
  Если у вас уже стоит версия 2.1 (R600) или новее, то этот шаг нужно пропустить!

Обновление движка с 2.1 (R600) до 2.1.5-LTS

• Приступая к этому шагу, убедитесь что у вас движок по состоянию соответствует 2.1 (R600) версии, если же нет, то вернитесь к прошлому шагу.
  Итак, для обновления движка посмотрите данную инструкцию, которая поможет вам обновить ваш движок до состояния последней LTS версии.

🔑 Права доступа на папки и файлы

Исходя из настроек вашего сервера, устанавливаем рекомендуемые права доступа (chmod) на указанные папки 777, а на файлы внутри этих папок (кроме файлов .htaccess и .keep) 666:

• data/avatars
• data/old_files
• 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

⚓️ Необходимая версия php

Минимально поддерживаемой версией PHP в настоящий момент является 5.3.4. Существует поддержка вплоть до 5.6 последних версий. Поддержка PHP 7 и выше - отсутствует.

⚓️ Необходимые настройки php

mbstring.internal_encoding = UTF-8
magic_quotes_gpc = Off

Внести данные настройки необходимо в файл php.ini. Их вам может установить ваш хостер по запросу, если у вас возникают какие-либо проблемы с их самостоятельной установкой. Впрочем, эти настройки могут быть установлены на сервере по умолчанию, поэтому их внесение требуется исключительно по необходимости.

⚓️ Необходимые модули php

php5-tidy
mbstring
bcmath
intl
mysql

Начиная с версии 2.0.9 (ревизия 592 в старой нумерации) модуль php5-tidy не является обязательным, но его установка крайне рекомендуется для повышения качества обработки html-кода тем и сообщений пользователей.

⚓️ Рекомендуемый способ запуска cron.php

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

⚓️ Локальный файл конфигурации

Начиная с ревизии 599 была добавлена поддержка автоматического подключения файла library/config.local.php, при создании его вами. Данный файл является заменой library/config.php для конкретного сервера, на котором запущен трекер (При создании library/config.local.php он будет загружаться вместо library/config.php).

⚓️ Файл конфигурации для модов

Начиная с версии v2.1.5-2023.09 была добавлена автоматическая загрузка настроек для модификаций из файла library/config.mods.php. Данный файл уже присутствует по умолчанию, при желании его можно удалить. Настройки для модификаций лучше указывать именно в нем, вместо того, чтобы писать их в library/config.php. Это сделано для удобства, чтобы отделить настройки движка и настройки модов.

⚓️ Установка Ocelot

В движок встроена по умолчанию поддержка альтернативного компилируемого анонсера - Ocelot. Настройка производится в файле library/config.php, сам анонсер находится в этом репозитории.

Инструкция по сборке приведена на нашем форуме. Для работы анонсера требуется замена двух таблиц в базе данных - дамп в файле: install/sql/ocelot.sql.

⚓️ Папка install

В корне движка присутствует папка install, в которой находятся служебные файлы, необходимые для его установки (дамп базы, примеры конфигов) и обновления (дамперы, скрипты конвертации). Доступ к данной папке по умолчанию закрыт, но если ее присутствие вам мешает - вы можете ее удалить. На файлы README.md, .git, .github, .gitignore, CHANGELOG.md, CODE_OF_CONDUCT.md и CONTRIBUTORS.md это также распространяется.

📌 Полезные ссылки

• Наш форум: https://torrentpier.com/
• Центр загрузки: https://get-torrentpier.duckdns.org/
• Часто задаваемые вопросы: https://faq.torrentpier.com/
• Где задать вопрос: https://torrentpier.com/forums/10/