Although Wacintaki Poteto is based on the OekakiPoteto 5.1.0a source code, it differs considerably from OekakiPoteto. Please read this document thouroughly.
Welcome to my fork of the OekakiPoteto 5.x source. This version has a few new features compared to the original version of Poteto, but is mostly a modernization. It includes proper HTML/CSS support, a reworked template system, thumbnails, group projects, significantly lower bandwidth usage, several bug and security fixes, and it runs on a wider variety of servers and configurations. It also has complete support for Shi-Painter, and the ability to add rules and a banner.
This BBS is designed to fill the gap between Poteto 5.x and the new version, Poteto 6.0, which is still in development. I don't intend to redesign this version or rework the database until Poteto 6.0 has been released. I intend to offer an upgrade path from Wacintaki to Poteto 6.0.
A major disadvantage compared to OekakiPoteto 5.x include incompatibility with Poteto templates. Until I write a proper template converter, you will have to make new templates or use the defaults.
In terms of new features, Wacintaki has essentially been discontinued as of version 1.3, though fixes will continue to be made. I am currently working on an all-new oekaki system to replace Wacintaki. Check for new versions, downloads, and patches here: www.NineChime.com/products/
Note: Refer to “manual.html” for help on how to upload files via FTP and how to CHMOD files.
If you are updating an existing board, skip this secion and see the update instructions below.
Copy all the files from the “oekaki” folder into a folder on your server. The destination folder may be any name, but all lower-case letters is recommended since URLs are generally case-sensitive.
Do NOT upload the documentation folder or anything else outside the “oekaki” folder of this distribution. It sounds silly to point this out, but it's a fairly common mistake!
Use your FTP program to CHMOD the appropriate files. If you are not sure how to do this, check the documentation that comes with your FTP utility or ask your system administrator. Use the following numbers:
755 (preferred) or 775: ./pictures (or whatever pictures folder you use) ./templates (important for template generation) ./resource (contains files that may be regularly changed by the BBS)
Normally the files in the resource folder are generated automatically. If you create them manually, use the following numbers:
664: resource/banner.php resource/hosts.txt resource/ips.txt resource/notice.php resource/rules.php
If you upload config files or any pictures via FTP, note that you may have to CHMOD the files with less restrictive numbers, such as 777 for folders or 666 for files. This is because the PHP scripting language is running on a different security group than your FTP program, and thus will need more “public” permissions. This may result in other people on your server being able to access your files via a system shell, so always try to use the highest security that works properly.
Run install.php and follow the directions.
After installing the BBS, you will be prompted to press a button to finalize the installation. This will removed the install.php and update.php files from the BBS. Neglecting to remove these files can result in serious security issues. If the BBS cannot delete these files for you, it will let you know, and you MUST delete them manually.
Two preview images are available. The default is preview.png, the second is preview2.png. You can replace them with any PNG image you like, but an image equal to the default canvas size is recommended (the default is 300 x 300). Select new preview images using the installer or control panel, or simply overwrite the ones that come with Wacintaki Poteto.
The OekakiBBS paint applet was removed from Wacintaki in version 1.2.5, due to licensing questions, as well as compatibility isses between the applet and newer versions of Java. The problems with Java made it difficult or impossible for members to submit pictures. However, Wacintaki still has the framework to support the applet.
To enable OekakiBBS, copy the “oekakibbs.jar” file into the “oekaki” folder. Wacintaki will see it and add it to the draw screen. The applet is bundled with OekakiPoteto and older versions of Wacintaki and Wax Poteto. Versions of OekakiBBS newer than v2.64 will not work with Wacintaki, as they are exclusive to www.OekakiBBS.com and will not properly connect to other servers.
If you are upgrading an older version of Wacintaki, you may remove support for it by deleting the JAR file. Note that if the JAR is removed, animations for old OekakiBBS drawings will no longer play.
Make a backup of your “resource” folder! This folder includes your rules, ban list, pr0n placeholder and preview images, etc.
A complete database backup would be a good idea, too, but if you know how to do that, chances are you've done it already. ;)
Copy all the files into place, overwriting those that already exist. As of version 1.2.2, Wacintaki will no longer overwrite your rules, banner, ban list, etc.
Wacintaki 1.1.4 introduced a new “hacks.php” file in the resource folder to control cookies and other advanced things. If you have edited your “functions.php” and “header.php” files to share cookies with multiple boards, you will need to copy the changes into the new “hacks.php” file. Do not edit the “hacks.php” file unless you have a good reason to do so.
View the BBS. Some Wacintaki updates will not need to run an updater, others will. The BBS will tell you what needs to be done.
To upgrade from an older version of OekakiPoteto, carefully follow the directions below. The updater cannot do all of this for you because of how UNIX security works (it can take ownership of the files away from you!)
If you need to go back to your old version of OekakiPoteto, make backups of your dbconn.php and config.php files, and everything in your templates and language folders. Please note that the update.php script does not support downgrading, but keeping backups of your old files is recommended.
Empty the “templates” and “language” folders. It is not necessary to delete the actual folders. This version of Poteto is not compatible with your old templates and language files, and failing to remove the old files can result in problems. Future versions of Wacintaki Poteto may include a template converter/editor.
Upload all the files from this distribution into your old Poteto folder and verify the CHMOD setting of all the files. Use the CHMOD numbers from the installation instructions above.
Move your existing “hosts.txt”, “ips.txt”, and “notice.php” files into the “resource” folder. This will preserve your banlist and notice. You can also copy your “pr0n.png” and “preview.png” images into the resource folder. The resource folder contains all the files that make your BBS unique, like the banner and rules, and all files that must be CHMODed to 664 or 666. Make sure the files are CHMODed correctly after you move them.
Run update.php. If you accidently view the index, it will tell you to run the updater. The update script will give you a number of options depending on which version of Poteto you are already using. You can upgrade from Poteto 4.x or 5.x, or one of the early developer versions of Wacintaki Poteto.
If there is a weird problem, try running the updater again. This will verify the database and rebuild the picture indexes. Note that some database error may still be returned if the updater is run multiple times. Normally, this is not a problem, though errors related to locked folders must be dealt with appropriately. A folder is locked if its CHMOD number is incorrect, and is therefore not writable.
IMPORTANT: After updating the BBS, you will be prompted to press a button to finalize the update. This will remove the install.php and update.php files from the BBS. Neglecting to remove these files can result in serious security issues. If the BBS cannot delete these files for you, it will let you know, and you MUST delete them manually.
The BBS should now be updated. Read the troubleshooting section if you encounter problems.
If experiencing long page load times (greater than 5 seconds), open up the “hacks.php” file and change the DISABLE_DNS_HOST_LOOKUP value to 1. Host names are not a vital to the ban list, and in some rare cases host lookup can cause major performance problems.
Consult the manual for a more complete list of troubleshooting issues not related to installation and updating.
If upgrading, do not change the location of your pictures folder or add an image name prefix.
This problem is most common on free servers. If the installer refreshes after you submit your information, but does not seem to do anything or return any errors, your server might have a strict filter policy in place. Many servers with comment filters will not return errors if a word match is made, and will just dump all information submit to the server. Sometimes 403 (Forbidden) or 404 (Not Found) errors will also be returned.
Observe your site's Terms of Service and avoid using certain questionable words. Also note that this behavior may extend to other oekaki services, such as comment posts and the chat room. Check your host's FAQ or support forum to see if any threads explain what is being filtered.
Many of the installer options may be changed later in the oekaki control panel. Some options that cannot be altered in the control panel are the database fields, the picture name prefix, encryption key, name and location of pictures folder, and your admin login.
Make sure your server supports MySQL. Other SQL databases are not supported.
You must create a database for the installer to use -- the installer will only set up the database you allocate for it. Ask your sysadmin how to do this.
Do not confuse the database name and database prefix. The database name tells the server which MySQL database shall be used for all your Wacintaki Poteto boards. The prefix tells the MySQL database which tables are used to store information about one or more of your boards. For example, if your database is named “WacBase”, do not type as a prefix “WacBase.op_” or “WacBase-op_”. The default prefix is just “op_”.
The update.php script can be safely run multiple times if needed. Take note of any error messages it returns, though some database errors are normal if update.php is run multiple times.
If the installer refuses to work, try removing all the databases before re-installing.
If your database still has information in it and you lose your config.php and dbconn.php files, you should ask your admin to clean out the SQL database you use. Be sure to tell the admin which database you want to remove, as an SQL server can use many databases for many different applications.
If uninstalling a single board, make sure you remove both the main database and member profiles.
If you have multiple boards sharing one member profile database, make sure to only delete the main database, and not the profiles database, or all of your boards will cease to function!
Make sure capitalization is correct. On some servers, there is a difference between “preview.png” and “Preview.PNG”. Using names in all lower-case letters is recommended.
A server will return a 500 error when a script is attempting to do something the server does not like. For PHP scripts, this usually means the folders are using access permissions that are too generous, and the server is enforcing a higher security level. It may also mean that “.htacess” files do not work on the server. If you have copied the “.htaccess” file from the documentation folder to the server, try removing it.
A 403 error is when folder or file permissions are too restrictive.
See the next section on File Permissions.
Make sure the templates, pictures, and resource folders are CHMODed to 755 or 777, otherwise, the server won't be able to generate the templates, save pictures, or edit your banner, ban list, etc.
Some servers do not allow you to CHMOD folders to 777, and may return a 500 server error. Use 755, which is preferred, anyway.
In very rare cases when 755 is used, a server may return a 403 error, or Wacintaki may complain that a folder is still locked. Try using 775 in these cases. Only folders should have a CHMOD number with a 7 in it. Writable files should always work with 644 or 664.
Older OekakiPoteto boards will not function if you CHMOD folders to 755. If you need to revert to OP 5.x, make sure you CHMOD all folders to 777.
If your server tells you that you don't have permission to CHMOD any files or folders in your own account, try deleting the files/folders and then recopying or creating them with your FTP program. This is a UNIX/Linux quirk, and may occur when scripts create files automatically.
If you are completely unable to delete any files or folders, then you must CHOWN the files. Usually, only a system administrator can do this.
If you lose your owner status, edit flagrestore.php in the documentation folder, upload it to the BBS folder, and run it. An OekakiPoteto board is supposed to have only one owner.
Thumbnails will only work with servers that have the GDlib graphics library installed and the library has been enabled in PHP. To enable GDlib, open your “php.ini” file and look for the section on Dynamic Extensions. Below, there will be two extensions that are disabled with a semicolon, “php_exit.so” and “php_gd2.so”. Enable both these extentions.
Note #1: on Windows, the libraries will have a “.dll” extension, not “.so”.
Note #2: make sure the EXIF extension is enabled before the gd2 extension, or some JPEGs may not work correctly. JPEG is just a compression system used in different file formats, including JFIF, the de-facto JPEG format. EXIF is the “guts” of non-JFIF JPEG format, and may be required for images from digital cameras and paint programs other than the Oekaki applets.
If your page looks very plain, go to the control panel and make sure your default template is correct. Remember that old Poteto templates will not work with Wacintaki Poteto. If there are old templates still installed, remove them, then use the “Reset All Templates” feature in the control panel.
If a template doesn't look right, delete the CSS version of the template. A new template will be rebuilt automatically from the PHP template code.
Please read the manual (specifically, the troubleshooting section) in the documentation folder of this distribution before seeking help.
Before reporting bugs, make sure you have the latest stable version of Wacintaki.
For help using Wacintaki or to report a bug, please visit the NineChime Forum. The forum does not require registration and all questions regarding OekakiPoteto, Wax Poteto, and Wacintaki are welcome.
Please do not ask questions about Wacintaki Poteto on OekakiPoteto forums. Wacintaki functions very differently compared to OekakiPoteto and you may not be able to get any help.
Wacintaki Poteto is based on the OekakiPoteto 5.1.0a source, and has been released with permission from Theo Chakkapark. Changes are ©Copyright 2004-2007 Marc A. Leveille. New versions of Wacintaki Poteto and the update.php file may be downloaded from www.NineChime.com/products/
OekakiPoteto 5.x ©Copyright 2001-2003 Theo Chakkapark and Marcello Bastea-Forte. OekakiPoteto 5.x may be downloaded from www.suteki.nu
Please contact Theo Chakkapark regarding license questions about OekakiPoteto. Please contact me regarding technical issues or bugs with Wacintaki.
New versions of OekakiPoteto (6.0+) are distributed under the Academic Free License (AFL), and may be downloaded from SourceForge.net.
See manual.html for a complete list of credits.