Step #1

The first step in installing Adsense Inbox is to install a copy of WordPress blog.

Download a copy of Word press athttp://wordpress.org/download/

Click Here to go to the Wordpress Installation instruction page.

We do not provide direct install instructions for the wordpress blog here, please use the links above for the WordPress install details.

Once you have completed the install of the WordPress blog script you can then proceed to install Adsense Inbox with the instructions below.

Step #2

Overview
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The script is implemented in a form of WordPress plugin.

It consist of following scripts:

cron_poster.php - the main script that connects to mail server and saves emails to your WordPress database. IThis is to be run by a cron scheduler.

You can use following syntax for setting up your cron job:

/usr/bin/php -f /home/adsensei/public_html/wordpress/wp-content/plugins/adsense_inbox/cron_poster.php

adsense_inbox.php - the plugin itself that create a new menu in WordPress admin panel and allow to configure the main script.

The remaining 4 files are additional libraries used by main script:

Akismet.class.php
class-pop3.php
mimedecode.php
PEAR.php



Installation
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Installation is easy as with any other WordPress plugins.

Unzip the included file "Adsense Inbox"

1. Upload contents of the "Adsense Inbox" folder directly into the same folder you installed WordPress into on your website. This inccludes uploading the folders

images
and
wp-content

So they will over write these two files in your WordPress Installation, no files will actually be over wirtten, new files will just be placed into the proper place in your WordPress install.

2. Create a POP3 email address in your c-Panel, this is the email address you will use to subscribe to any email lists whos email you wish to display in your new Adsense Inbox.  It should be set up as yourname@yourdomain.com and be sure you write down the login password you select you will need it soon!

3. Setup your Cron, in c-Panel setup a cron to tell Ansense Inbox how often to check for new email.

Our Cron job is setup as
/usr/bin/php -f /home/adsensei/public_html/wordpress/wp-content/plugins/adsense_inbox/cron_poster.php

Things to consider when setting up your cron.  In our example above the term "adsensi" is our site path on our server so yours will be what ever your site path is, if you do not know whatthis is ask your web host.

Also in our example above you see "wordpress" this is because our copy of WordPress is installed in a folder with the name wordpress, if you install yours in a folder called blog, then you would have blog in this place or if you install your copy of wordpress right in the root of your domain you woudl get rid of wordpress/ in the example above.

We set our Cron Job to check for new email once per hour, you may set yours to check it any any intervall you wish such as once per day, once per hour, or even once every fifteen minutes.

If while testing your email setup you wish to trigger the cron without waiting for the set time you can do so by directing your browser to
http://www.yourdomain.com/wordpress/wp-content/plugins/adsense_inbox/cron_poster.php

The above link assumes you installed your WordPress blog in a folder calles wordpress on your domain.

Step #3

Login to your newly installed copy of WordPress with the user name and password you selected and Go to your Admin -> Plugin and activate "Adsense Inbox". After successful activation the plugin adds a new menu link into your WordPress blog called  "Adsense Inbox".

Step #4

Configuration
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
There are following submenus under "Adsense Inbox":

* Adsense Inbox
* Stats
* Rules
* Cleaner
* Options
* AdSense
* Disclaimer


-Adsense Inbox
~~~~~~~~~~~~~~~~
This screen allows you to review/edit/delete all email that has arrived to system.
Please note that this screen will always remain clean & empty if you switch off the moderation mode in your WordPress blog.

When you receive email from a new sender when Moderation is set to on, it will be held here until you approve it.  To do this click "edit" as seen below and then select publish on the next screen.  This user will now be approved for all future mail they send. Their will also be a new category created for all email from this sender.

You can also "view" or "delete" email in this section as well.

-Stats
~~~~~~~~~~~~~~~~
On this screen you can find statistics for each sender posting to system. By clicking on sender name you will see the statistics for each email sent by given person. Also the plugin monitors the visits from Google and by extracting the keywords from referring url it saves the stats for keywords too.

Here is a shot of the stats page as mentioned above.

-Rules
~~~~~~~~~~~~~~~~
On this screen you configure an email processing rules. Each rule is keyed by either person email or by person name. By selecting the action you can "MOVE" any email to any preexisting category, "drop" it or make the keyed person preapproved by selecting "Publish" when posting mode is set to Draft (moderation ON).

-Cleaner
~~~~~~~~~~~~~~~~
This section allows you to configure email cleanup rules. This feature is used to remove unwanted information from the bottom of emails. For example in emails sent by mailing list robots there is an unsubscription information that you would never want to be displayed in your Ansense Inbox blog posts. To configure the new rule you simply specify the starting text that marks the beginning of all the text you wish to be removed and Adsense Inbox removes everything until the end of message that appears after this text.

-Options
~~~~~~~~~~~~~~~~
On this screen you configure the email server information, the posting options and akismet spam protection.

Post status: Draft or Publish. If you select Draft all emails will first go to moderation queue. As I noted above you can override this for certain emails/names.

Encoding: UTF-8 or ISO8859-1
Ping status: On or Off
Comments status: On or Off

Akismet is the free antispam service of wordpress.com. This is an automated online service for checking blog or forum posts for spam in real-time.

-Adsense
~~~~~~~~~~~~~~~~
On this screen you configure the content of 2 ad blocks by either entering your Adsense code or any other HTML ad you wish.

If you use our included theme these ad blocks are already included in the theme.

If you use your own theme the blocks then can be added to your theme and shown anywhere in your theme blog by simply adding  the following tags into your theme, you can also use our included theme which already has these tags included:

<?php theme_adsense1();?>
<?php theme_adsense2();?>

or better following syntax so you don't get an error if you disable the "AdSenseInbox" plugin and forgot to remove the tags from your theme:

<?php if (function_exists('theme_adsense1') theme_adsense1();?>
<?php if (function_exists('theme_adsense2') theme_adsense2();?>

-Disclaimer
~~~~~~~~~~~~~~~~
On this screen you configure the 2 text or html sections that starts and ends the text of all blog posts.

You may use this area to add an additional advertisement to all posts or to add a disclaimer such as this one below.

*DISCLAIMER* This is my online email box, by sending me email you are directly sending your email into my public online email box which is viewable by myself and anyone else that happens to find my website. If you wish to not have your emails appear here please remove me from our email list by removing my email address from your future mailings. This email address is admin@mydomain.com You may also request that I remove any of your previously sent email in writing at the email address above.

Start Receiving Email

Your Adsense Inbox is now setup.  The best way to use this inbox is to signup for theme based email lists.

If you are targeting 'Pet Products' signup only to pet related email lists. Use new domains and installs to target separate niche markets.

YOU can change the header image of the included blog theme by changing the header.jpg image in the images folder, also as mentioned above you are welcome to use your own blog theme just be sure to place the Adsense codes into your theme wherever you wish your ads to appear, alternatively you may also just hard code your ads right into your theme.

Enjoy, Adsense Inbox the possibilities for its use are limitless, use your imagination!