tinyib/README.md

138 lines
7.0 KiB
Markdown
Raw Normal View History

# TinyIB
[![Translate](https://hosted.weblate.org/widgets/tinyib/-/tinyib/svg-badge.svg)](https://hosted.weblate.org/projects/tinyib/tinyib/)
[![Donate](https://img.shields.io/liberapay/receives/rocketnine.space.svg?logo=liberapay)](https://liberapay.com/rocketnine.space)
2018-07-20 18:59:29 +00:00
A lightweight and efficient [image board](https://en.wikipedia.org/wiki/Imageboard). See [TinyIB Installations](https://gitlab.com/tslocum/tinyib/wikis/Home) for demos.
Features
------------
2010-06-22 07:52:15 +00:00
**Got database? Get speed.** Use [MySQL](https://mysql.com), [PostgreSQL](https://www.postgresql.org) or [SQLite](https://sqlite.org) for an efficient set-up able to handle high amounts of traffic.
2010-06-22 07:52:15 +00:00
2013-04-15 01:05:08 +00:00
**No database? No problem.** Store posts as text files for a portable set-up capable of running on virtually any PHP host.
2018-06-08 05:23:38 +00:00
**Not looking for an image board script?** TinyIB is able to allow new threads without requiring an image, or even disallow images entirely. See the [Text Board Mode](https://gitlab.com/tslocum/tinyib/wikis/Text-Board-Mode) wiki page for instructions.
2014-06-24 19:51:22 +00:00
- GIF, JPG, PNG, SWF, MP4 and WebM upload.
- YouTube, Vimeo and SoundCloud embedding.
2016-07-19 21:14:54 +00:00
- CAPTCHA (A simple implementation is included, reCAPTCHA is also supported)
- Reference links >>###
2013-04-15 01:05:08 +00:00
- Delete post via password.
2020-09-03 02:05:36 +00:00
- [Translations](https://hosted.weblate.org/projects/tinyib/tinyib/):
- French
- Norwegian
2013-04-15 01:05:08 +00:00
- Management panel:
- Administrators and moderators use separate passwords.
2020-07-31 23:16:37 +00:00
- Moderators are only able to sticky threads, lock threads, delete posts, and approve posts when necessary. (See ``TINYIB_REQMOD``)
2013-04-15 01:05:08 +00:00
- Ban offensive/abusive posters across all boards.
- Post using raw HTML.
2013-07-31 04:37:07 +00:00
- Upgrade automatically when installed via git. (Tested on Linux only)
2013-04-15 01:05:08 +00:00
Install
2010-12-31 23:24:55 +00:00
------------
2010-06-22 07:52:15 +00:00
1. Verify the following are installed:
- [PHP 4.3+](https://php.net)
- [GD Image Processing Library](https://php.net/gd)
- This library is usually installed by default.
2014-10-28 22:12:43 +00:00
- If you plan on disabling image uploads to use TinyIB as a text board only, this library is not required.
2013-04-15 01:05:08 +00:00
2. CD to the directory you wish to install TinyIB.
3. Run the command:
2018-06-08 05:23:38 +00:00
- `git clone https://gitlab.com/tslocum/tinyib.git ./`
2013-04-15 01:05:08 +00:00
4. Copy **settings.default.php** to **settings.php**
5. Configure **settings.php**
- When setting ``TINYIB_DBMODE`` to ``flatfile``, note that all post and ban data are exposed as the database is composed of standard text files. Access to ./inc/flatfile/ should be denied.
- When setting ``TINYIB_DBMODE`` to ``pdo``, note that only the MySQL and PostgreSQL databases drivers have been tested. Theoretically it will work with any applicable driver, but this is not guaranteed. If you use an alternative driver, please report back.
- To require moderation before displaying posts:
- Ensure your ``TINYIB_DBMODE`` is set to ``mysql``, ``mysqli``, or ``pdo``.
- Set ``TINYIB_REQMOD`` to ``files`` to require moderation for posts with files attached.
- Set ``TINYIB_REQMOD`` to ``all`` to require moderation for all posts.
- Moderate posts by visiting the management panel.
- To allow video uploads:
- Ensure your web host is running Linux.
- Install [mediainfo](https://mediaarea.net/en/MediaInfo) and [ffmpegthumbnailer](https://code.google.com/p/ffmpegthumbnailer/). On Ubuntu, run ``sudo apt-get install mediainfo ffmpegthumbnailer``.
- Add desired video file types to ``$tinyib_uploads``.
- To remove the play icon from .SWF and .WebM thumbnails, delete or rename **video_overlay.png**
- To use ImageMagick instead of GD when creating thumbnails:
- Install ImageMagick and ensure that the ``convert`` command is available.
- Set ``TINYIB_THUMBNAIL`` to ``imagemagick``.
- **Note:** GIF files will have animated thumbnails, which will often have large file sizes.
- To use TINYIB in another language:
- Set ``TINYIB_LOCALE`` to a language code found in `locale/`.
2020-09-03 02:05:36 +00:00
- Ensure you are running PHP 5.4+.
6. [CHMOD](https://en.wikipedia.org/wiki/Chmod) write permissions to these directories:
2013-04-15 01:05:08 +00:00
- ./ (the directory containing TinyIB)
2012-05-18 07:37:50 +00:00
- ./src/
- ./thumb/
- ./res/
2014-11-04 23:53:06 +00:00
- ./inc/flatfile/ (only if you use the ``flatfile`` database mode)
2013-04-16 01:20:08 +00:00
7. Navigate your browser to **imgboard.php** and the following will take place:
2013-04-15 01:05:08 +00:00
- The database structure will be created.
- Directories will be verified to be writable.
2018-07-20 22:48:07 +00:00
- The board index will be written to ``TINYIB_INDEX``.
2010-12-31 23:24:55 +00:00
Moderate
2014-06-24 19:51:22 +00:00
------------
1. If you are not logged in already, log in to the management panel by clicking **[Manage]**.
2. On the board, tick the checkbox next to the offending post.
3. Scroll to the bottom of the page.
4. Click **Delete** with the password field blank.
- From this page you are able to delete the post and/or ban the author.
Update
2010-12-31 23:24:55 +00:00
------------
2014-06-28 08:57:30 +00:00
1. Obtain the latest release.
- If you installed via Git, run the following command in TinyIB's directory:
- `git pull`
2018-06-08 05:23:38 +00:00
- Otherwise, [download](https://gitlab.com/tslocum/tinyib/-/archive/master/tinyib-master.zip) and extract a zipped archive.
2014-06-28 08:57:30 +00:00
2. Note which files were modified.
- If **settings.default.php** was updated, migrate the changes to **settings.php**
2013-04-15 01:05:08 +00:00
- Take care to not change the value of **TINYIB_TRIPSEED**, as it would result in different secure tripcodes.
2014-06-28 08:57:30 +00:00
- If other files were updated, and you have made changes yourself:
2018-06-08 05:23:38 +00:00
- Visit [GitLab](https://gitlab.com/tslocum/tinyib) and review the changes made in the update.
2013-04-16 03:15:47 +00:00
- Ensure the update does not interfere with your changes.
2018-07-20 18:59:29 +00:00
Migrate
------------
TinyIB includes a database migration tool, which currently only supports migrating from flat file to MySQL. While the migration is in progress, visitors will not be able to create or delete posts.
1. Edit **settings.php**
- Ensure ``TINYIB_DBMODE`` is still set to ``flatfile``.
- Set ``TINYIB_DBMIGRATE`` to ``true``.
- Configure all MySQL-related settings.
2. Open the management panel.
3. Click **Migrate Database**
4. Click **Start the migration**
5. If the migration was successful:
- Edit **settings.php**
- Set ``TINYIB_DBMODE`` to ``mysqli``.
- Set ``TINYIB_DBMIGRATE`` to ``false``.
- Click **Rebuild All** and ensure the board still looks the way it should.
If there was a warning about AUTO_INCREMENT not being updated, you'll need to update it manually via a more privileged MySQL user. Run the following query for one or both of the tables, dependant of the warnings you were issued:
``ALTER TABLE (table name) AUTO_INCREMENT = (value to be set)``
2012-05-18 07:37:50 +00:00
Support
------------
1. Ensure you are running the latest version of TinyIB.
2018-06-08 05:23:38 +00:00
2. Review the [open issues](https://gitlab.com/tslocum/tinyib/issues).
3. Open a [new issue](https://gitlab.com/tslocum/tinyib/issues/new).
2012-05-18 07:37:50 +00:00
Translate
------------
Translation is handled [online](https://hosted.weblate.org/projects/tinyib/tinyib/).
Contribute
2011-01-07 10:17:09 +00:00
------------
2018-06-08 05:23:38 +00:00
1. Read the [GitLab Forking Workflow](https://docs.gitlab.com/ce/workflow/forking_workflow.html).
2013-04-15 01:05:08 +00:00
2. Fork TinyIB.
3. Commit code changes to your forked repository.
4. Submit a pull request describing your modifications.