tinyib/README.md

68 lines
2.7 KiB
Markdown
Raw Normal View History

2013-07-31 04:35:25 +00:00
TinyIB - A Lightweight and Efficient [Image Board](http://en.wikipedia.org/wiki/Imageboard) Script
2010-12-31 23:24:55 +00:00
====
2010-06-22 07:52:15 +00:00
2013-04-15 01:05:08 +00:00
**Got database? Get speed.** Use [MySQL](http://mysql.com) or [SQLite](http://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.
2013-04-23 21:04:15 +00:00
For demos see [example installations](https://github.com/tslocum/TinyIB/wiki). [![githalytics.com alpha](https://cruel-carlota.pagodabox.com/5135372febbc40bacddbb13c1f0a8333 "githalytics.com")](http://githalytics.com/tslocum/TinyIB)
2012-05-18 07:37:50 +00:00
Features
------------
- Reference links >>###
2013-04-15 01:05:08 +00:00
- Delete post via password.
- Management panel:
- Administrators and moderators use separate passwords.
- Moderators are only able to delete posts.
- Ban offensive/abusive posters across all boards.
- Post using raw HTML.
2013-07-31 04:36:51 +00:00
- Upgrade automatically (when installed via git, tested on Linux only)
2013-04-15 01:05:08 +00:00
2010-12-31 23:24:55 +00:00
Installing
------------
2010-06-22 07:52:15 +00:00
2013-04-15 01:05:08 +00:00
1. Verify the following requirements are met:
- [PHP](http://php.net) 4 or higher is installed.
- [GD Image Processing Library](http://php.net/gd) is installed.
- This library is installed by default on most hosts.
2. CD to the directory you wish to install TinyIB.
3. Run the command:
2010-12-31 23:33:22 +00:00
- `git clone git://github.com/tslocum/TinyIB.git ./`
2013-04-15 01:05:08 +00:00
4. Copy **settings.default.php** to **settings.php**
5. Configure **settings.php**
2013-04-16 01:20:08 +00:00
6. [CHMOD](http://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/
- ./inc/flatfile/ (only if you use flat file for the database)
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.
- The file index.html will be created containing the new image board.
2010-12-31 23:24:55 +00:00
Updating
------------
2013-04-15 01:05:08 +00:00
1. Run the command:
- `git pull`
2. If TinyIB has been updated, note which files are modified.
- If **settings.default.php** is updated, migrate the changes to **settings.php**
- Take care to not change the value of **TINYIB_TRIPSEED**, as it would result in different secure tripcodes.
2013-04-16 03:15:47 +00:00
- If other files are updated, and you have made changes yourself:
- Visit [GitHub](https://github.com/tslocum/TinyIB) and review the changes made in the update.
- Ensure the update does not interfere with your changes.
2011-01-07 10:17:09 +00:00
2012-05-18 07:37:50 +00:00
Support
------------
Contact tslocum@gmail.com
2011-01-07 10:17:09 +00:00
Contributing
------------
2013-04-15 01:05:08 +00:00
1. Read the [GitHub Forking Guide](http://help.github.com/forking/).
2. Fork TinyIB.
3. Commit code changes to your forked repository.
4. Submit a pull request describing your modifications.