FAQ

Installation Instructions

1. Unzip the plugin archive and put ktai-entry folder into your plugins directory (wp-content/plugins/) of the server.
2. Before activate the plugin, you need to configure an mail address.
   • (Case of retrieving message of external mailbox)
   • Prepare an exclusive posting email address. Please avoid to select existing mail address that you are already usging. It is OK to get no-charge addresses like Gmail, Yahoo! Mail.
   • At Post via e-mail section (in Writing Settings of WordPress admin panel), type in your POP3 settings: Mail Server, Login Name, Password, Default Mail Category. Ktai Entry Reflects “Default Mail Category”.
   • (Case of kicking the posting script)
   • Create a secret posting address. For example, execute below commands in a shell:
     php -r ‘echo md5(uniqid(rand(), true)) . “\n”;’
     * Login to the mail server by shells, create the .qmail-SECRET or .foreard+SECRET file (SECRET means the string created before) If you create the file, qmail/postfix serves a mail address like USER-secret@example.com, USER+secret@example.com. (USER means your user account name) Take care not to include an upper characters or dot characters.
     * In the content of .qmail-SECRET/.forward-SECREt file like below. (Adjust the path to PHP, WordPress if needed)
     | /usr/bin/php /PATH_TO_WORDPRESS/wp-content/plugins/ktai-entry/inject.phpIn short, you may configure that arriving a mail to the address startsinject.php` script.
   • For WordPress MU, create .qmail-SECRET/.forward-SECRET files for each blog, and a -blog option needed to specify the blog_id (interger number).
     | /usr/bin/php /PATH_TO_WORDPRESS/wp-content/plugins/ktai-entry/inject.php -blog 2
     Next, comment out the define( 'SUNRISE', 'on' ); line in wp-config.php and copy ktai-entry/sunrise.php file under wp-content/ (as wp-content/sunrise.php). If there is already sunrise.php file under wp-content/, add the content of ktai-entry/sunrise.php after wp-content/sunrise.php.
3. Login to you WordPress site, and create a new user. The mail address of the user must be the email address from what you send post (like mail phone’s email, etc).
   If you want publish the post as soon as mail was send, the privilege of the user must be higher than and equal to author. If the user is a contributor, the post is pending or draft.
   If the user is a subscriber, posted mail is rejected.
4. Check the stylesheet of your theme. If the theme has no class of alignleft, aligncenter, alignright, clear, Add below code to style.css.
   img.alignright {
   padding: 4px;
   margin: 0 0 2px 7px;
   display: inline;
   }
   img.alignleft {
   padding: 4px;
   margin: 0 7px 2px 0;
   display: inline;
   }
   .aligncenter, div.aligncenter {
   display: block;
   margin-left: auto;
   margin-right: auto;
   }
   .alignright {
   float: right;
   }
   .alignleft {
   float: left
   }
   .clear {
   clear:both;
   }
5. Activate the plugin.
6. Configure the options “Post by Email” under “Settings” section. You can use default configuration.
   • APOP: The server needs APOP connection. Check this. DO NOT check if you use POP over SSL (Gmail, Yahoo! Mail etc)
   • POP3 retrieve interval: The interval of checking external POP3 mailbox. If you use the method of kicking the posting script, Select “None”.
   • Posting mail address (option): The address that you created above section. If the recipient field (To, CC) has not this address, the post is rejected. If this field is empty, recipient check is skipped. If you are unshure, keep this field blank.

Moving wp-content, or wp-content/plugins directory to non-standard position

After WordPress 2.6, you can move wp-content, or wp-content/plugins directory to non-standard position. If you move the directory, additional configuration is needed.

1. When installing the plugin, the permission of the ktai-entry directory to 757 or 777, so that the webserver can touch the directory.
2. Activate the plugin, then wp-load-conf.php file is automatically created. It is OK.

3. If the file is not created, you need to edit ktai-entry/wp-load.php manually. At line 20, change $wp_root variable to specify the absolute path to WordPress installed directory.

   e.g. WP diretory is /home/foo/puglic_html/wp-core/ and wp-content directory is /home/foo/public_html/wp-content/
   $wp_root = dirname(dirname(dirname(dirname(FILE)))) . ‘/wp-core/’;

Gmail Configuration

If you use Gmail to the external mailbox, like below:

1. Create a new Gmail account. If you have one, it is recommended to create another one.
2. At Gmail settings > Mail Forward and POP/IMAP settings > POP download, Select “”.
3. Make a random string. You can use a string displayed at “Post via Mail” section of WordPress admin panel. And, substitute upper character and punctuations from it. (e.g. aBM9dDu*^w$R -> abm9dduwr). Then chain the local part of your Gmail address and this random string with plus sign, and new address is made. (e.g. example@gmail.com and abm9dduwr results example+abm9dduwr@gmail.com.
4. Put the new address in “Posting mail address” field. Therefore, only the message posted to the address having random string (e.g. example+abm9dduwr@gmail.com) is accepted, normal address (e.g. example@gmail.com) is rejected.
5. Configure “Post via Email” of “Writing” settings like below:

• Mail Server: ssl://pop.gmail.com
• Port: 995
• Login Name: (Your Gmail adress) e.g. example@gmail.com
• Password: (Your Gmail password)