A nullchan-kusabaX based imageboard engine with some modern features

Этот процесс пока что не проверялся, но всё должно выглядеть так.

Если кто-то захочет развернуть курисабу у себя с нуля и поделится с нами своим опытом, например, в виде написания issue-в на github - мы будем очень рады.

• Развернуть LAMP или LNMP-сервер, опционально настроить Cloudflare, Let's Encrypt и т.п.
• Убедиться, что стоит PHP <= 7.x (Dwoo не умеет работать с PHP >= 8.0) с модулями mbstring, gd, curl, а также mysql или mysqli.
• Поставить imagemagick и gifsicle (если нужна поддержка, например, анимированных превьюшек и т.п.).
• Поставить git (чтобы работал update_engine.php).
• Скопировать шаблон config.php.template из каталога _templates в корень борды, поправить в нём необходимые поля (они все собраны в одном помеченном соответствующими словами месте).
• Если сервер - apache, то скопировать шаблон .htaccess.template из каталога _templates в корень борды, возможно, что-то в нём поправить в соответствии с настройками сервера.
• Если сервер - nginx, то сконфигурировать директивы error_page в конфиге сайта (обязательно с символом "=", иначе особые треды работать не будут), а также по возможности всё остальное по образцу из .htaccess.template:

    error_page 403 = /error.php?p=403;
    error_page 404 = /error.php?p=404;
    error_page 451 = /error.php?p=451;

• Возможно, потребуется прописать директивы типа client_max_body_size для nginx или аналогичную для apache.
• Создать базу данных с любым названием (если ещё не создана).
• Импортировать файл database.sql из каталога _templates в эту базу.
• Создать каталоги tmp, tmp/dwoo (настраивается в конфиге), tmp/xhrupload. Они должны быть доступны для записи веб-серверу. Можно удалить каталог _templates.
• После этого можно заходить в админку (http://example.com/manage.php, пользователь admin, пароль admin - разумеется, надо немедленно сменить!) и создавать секции (по умолчанию определена секция "борды") и доски на них.
• Можно либо скопировать главную (front.php) в корень борды из каталога _templates, либо подложить туда свою в соответствии с тематикой борды (и, возможно, поправить KU_MAINPAGE в конфиге). Для примера, главная Курисача есть в отдельном репозитории.
• Желательно положить фавиконку (favicon.ico) в корень борды.

Параметры в конфиге (по крайней мере, которые стоит трогать) описаны прямо в нём.

По сравнению с обычной кусабой в админке есть специальные пункты:

• пересоздать статическую карту ответов: так как карта ответов, в отличие от обычной 0chan-кусабы в курисабе статическая, то после массивных правок досок (к примеру, переноса тредов или влива дампа базы) она может сломаться, тогда следует выбрать этот пункт.
• сбросить лимит тредов: с целью защиты от вайпа в день можно создать не более KU_MAXTHREADSADAY тредов. Если нужно создать больше, то нужно выбрать этот пункт, и тогда отсчет KU_MAXTHREADSADAY пойдет с текущего момента, а не 24 часов до него, и можно будет создать новые KU_MAXTHREADSADAY тредов.
• специальные треды. О них ниже. Есть также пункт "подневная статистика по бордам /sg/ и /vg/" - его вообще можно выпилить или переделать так, как надо (этот пункт специфичен для "Курисача", первой и, собственно, родной борды для курисабы).

Для включения возможности блокировки постов/файлов по стране клиента, а также обратимого удаления файлов (то есть при восстановлении поста файл тоже восстанавливается) можно включить параметр KU_OFFLOAD в конфиге. Если это делается на уже работающей имиджборде, то необходимо помимо включения этого параметра, зайти в каталоги src и thumb каждой доски и добавить в .htaccess директиву:

Deny from all

Некоторые треды могут быть доступны по коротким ссылкам и из меню.

Их можно добавить в списке тредов для меню на странице "специальные треды" админки.

Формат записи:

{THREAD | HIDDEN} thread-id /link/ Thread-Name

Здесь:

• THREAD - показать тред в меню и сделать возможность переходить в него по ссылке
• HIDDEN - не показывать тред в меню, но всё равно сделать возможность переходить в него по ссылке
• thread-id - id ОП-поста,
• link - это ссылка, по которой он будет доступен,
• Thread-Name - имя треда, под которым он появляется в меню. Каждый блок записей THREAD/HIDDEN должна предварять строка вида BOARD boardname, где boardname - имя доски (без слэшей). Эта строка показывает, к какой борде относятся последующие треды.

К примеру, если там написано:

BOARD b
THREAD 12345 /vid/ Video Thread

то это означает, что в тред можно зайти как по обычной ссылке вида http://example.com/b/res/12345.html, так и по ссылке http://example.com/vid/.

Очевидно, названия имеющихся досок не должны совпадать с подобными ссылками на треды.

Если существует такой тред со ссылкой /faq/ - то в хедере страниц борд/тредов, а также в меню появится ссылка "FAQ". Этот тред логично объявить как HIDDEN, заблокировать и спрятать, чтобы он мог быть доступен только по ссылке, но не светился на борде.

Основная лицензия проекта - GPLv2.

Однако, поскольку как сама Kusaba X, так и 0chan-Kusaba в своём составе имеет много компонентов и там могут возникать проблемы с лицензиями, то для курисабы эта болезнь тоже справедлива.

Иконки файлов (inc/filetypes/*.png) сделаны на основе иконки авторства Icooon Mono с лицензией public domain и шрифта Arturito Slab авторства Denis Ignatov с лицензией SIL OFL 1.1.