Temporary E-mail Installation and Configuration Guide
Temporary E-mail Installation and Configuration Guide
3.3 File and Folder Permissions
4 Update to the Latest Version
4.3 File and Folder Permissions
Thanks for downloading and using our Temporary E-mail Script. The script provides you with disposable e-mail addresses which expire after a certain time. You can read and reply to e-mails that are sent to the temporary e-mail address within the given time frame.
The script requires either PHP/4 or PHP/5 on Unix/Linux/Windows and a MySQL database. You also need a software (WinZIP for example) to unpack the script files after downloading from our server. You should have a solid understanding of HTML and some experience with script installation.
With a click on a button the user generates a new e-mail address. That address will be stored in the database along with its creation time. The e-mail address is assigned to the user by a session cookie.
The user then uses the e-mail for any purpose where an e-mail address is required. Most commonly that will be some kind of registration.
In the background the script checks continuously for arriving e-mails. Once an e-mail that has been sent to a generated e-mail address arrives, the script displays it.
Learn more about how to configure the automatic e-mail check in chapter 2.3.3.5.
· User can generate e-mail addresses
· User can see incoming e-mails
· User can reply to e-mails
· Completely template driven
· Installation routine
The admin area homepage shows a few statistic figures:
· Created addresses
· Received e-mails
· Number of valid e-mails
· Number of expired e-mails
· Number of sent e-mails
This section allows you to change login name, e-mail, and login password.
You can set the default language for both areas of the script. That setting will be overwritten, if the user’s browser language settings are different or the user selects a language manually. The changed language setting will be stored in a cookie.
Set this option to “No” if you want to hide the language menu.
The folder /language/ contains the subfolder /utf8/ that contains UTF-8 encoded text. If you set this option to “Yes”, the script will use the language files from the subfolder.
You can shut the whole tool down, e.g. for maintenance. During the shut down the front end functions will not be available for the users, but the administrator can login to the admin area.
If set to “Yes” you can let the users know that the tool has been shut down. Otherwise they see just a blank screen.
By default the e-mail lifetime is set to 15 minutes. You can change the lifetime and even can set it to weeks, months and years.
In order for the script to receive e-mails an e-mail account (mailbox) must be created. It is important that the e-mail account is configured as catch-all. Each webhost handles the catch-all feature differently. Please contact your webhost about that, if you do not know whether your webspace package supports catch-all or how it can be turned on.
If your webspace manager is called "cPanel X" you need to create a mail account first and then go to Mail >> Default Address. If there is nothing set yet, click the link "Set Default Address" and enter the name of the e-mail account you want to use with the script.
If you want to connect to your mailbox through SSL and you mailbox supports SSL, set this option to “Yes”.
The key is kind of a password to make sure that no third party knows the exact URL that is called to check for incoming e-mails. If the key in the URL does not match the key in the settings, the script will not process the mail download.
The script uses the e-mail account data (chapter 2.3.3.7) to download incoming e-mails and display those e-mails to the users. The e-mail check requires a certain URL of the script to be called continuously.
You can find this URL in the admin area
-> Configuration -> General Settings -> Miscellaneous (bottom of the
page) -> Mail download URL.
If your webspace package contains crontab, you can create a cron job that calls the mail download URL.
If that is not the case you can use the cron job that the script provides. You can find it in the admin area -> Configuration -> Cron Job. Put the URL where it says URL and set the time between each URL call. We have found that 60 seconds is a good number.
The script has been configured in a way that makes it ready to use immediately. Please follow these steps:
1. Connect to your web server using an FTP program.
2. Create a new folder on your server named e.g. temporary_email. This way the script will be installed in a sub-directory. If you want to install the script directly in the root folder, just upload all files and folders to the root folder. It is not a requirement of the script to be installed in a sub-directory.
3. Upload the whole script including all files and folders to your server into the new folder. Make sure the original file structure appears on the server. Read more details in chapter 3.2 Upload.
4. Make sure that the script folder and the sub-folder cache are writable by the script (chmod 777). Read more details in the chapter 3.3 File and Folder Permissions. If those folders are not writable the installation will fail.
5.
Call the admin area of the script
in your browser:
http://www.example.com/temporary_email/admin/
6. You are probably seeing now the installation screen of the script. Please make sure you have the database access data. Read more details in chapter 3.4 Database Access Data.
7. Choose a prefix for the database tables. Default value is t12l_ and there is actually no need to change that unless you want to have more than one installation of the script side by side.
8. Enter the information for the admin account you want to use.
9. Click the button Install Now. In case the installation was successful, you will be provided with a link to the login screen where you can use the account data you just entered.
10. You can change the permissions of the script folder back to the value before, but the permissions of the folder cache must remain 777.
All files have to be uploaded in text mode (ASCII mode).
Most, if not all, FTP programs allow you to change the file permissions. That can either be done with a command line and the command chmod or with some clicks on menus and checkboxes.
We have published a guide with examples of common FTP programs on our website.
http://www.gentlesource.com/demos/demo-short-url-script/?chmod
You need following four items:
· Database hostname
· Database name
· Database user name
· Database password
You either get those data from your web space control panel or ask your web space provider about them.
Please make a backup of all your files, especially those in the folders /configuration/ and /template/. During the update process all existing files will be overwritten and all changes will be lost after that.
Please follow these steps:
1. Login to the admin area of the script and go to the backup section. Export a backup.
2. Connect to your web server using an FTP program.
3. Download the whole script folder to your local hard disk. This way you have a backup of all files and database tables in case the update fails and files or data are deleted.
4. Upload all files and folders of the new script version to your server into the folder that contains the existing script. Please be aware that all files are now overwritten by the new files. Make sure the original file structure appears on the server. Read more details in chapter 4.2 Upload.
5. Make sure the script folder and the sub-folder /cache/ are writable by the script (chmod 777). Read more details in the chapter 4.3 File and Folder Permissions. If those folders are not writable the installation will fail.
6.
Call the admin area of the script
in your browser, e.g.:
http://www.example.com/temporary_email/admin/
7. You are probably now seeing the update screen of the script. Please make sure you have the database access data at hand. Read more details in chapter 4.4 Database Access Data.
8. Enter the login data of the admin account.
9. Click the button Update. In case the update was successful, you will be provided with a link to the login screen where you can login as usual.
All files have to be uploaded in text mode (ASCII mode).
Most, if not all, FTP programs allow you to change the file permissions. That can either be done with a command line and the command chmod or with some clicks on menus and checkboxes.
You need following four items:
· Database hostname
· Database name
· Database user name
· Database password
You either get those data from your web space control panel or ask your web space provider about them.
The script uses a template system that makes it easy to customize the layout. In the folder /template/default/ reside all the HTML files that contain the layout of the front end.
layout.tpl.html |
Contains the layout of the front page. |
|
|
email.tpl.html |
Contains the details. |
|
|
style.css |
Contains the styles. |
In order to create a new template set create a new folder (i.e. /my_design/) inside the directory /template/. Copy at least the files layout.tpl.html and style.css from the folder default into your new folder. If you want to customize the complete page, you have to copy the file email.tpl.html too.
Open the file index.php and add following line of code on top of the file (but below <?php).
define('T12L_ALTERNATIVE_TEMPLATE', 'my_design');
Important: Replace my_design with the name of your layout folder.
All text can be found at one central place – the language files. For each language one file resides in the folder /language/. You can edit the files using a text editor. If you want to create a new language file, follow these steps:
1. Copy one of the existing language files and change the language abbreviation.
2. Open the new language file with a file editor and make your changes.
3. Open the file /configuration/default.inc.php and
look for the option
$t12l['available_languages']
Add your language to the array, i.e.:
$t12l['available_languages']
= array(
'en' => 'English',
'de' => 'German',
'es' => 'Spanish',
);
4. The new language should now appear in the admin area -> general settings.
Please note: The steps are the same for the language files inside the folder utf8, except that you need to save the files formatted as UTF-8 without BOM. If your editor only offers the option UTF-8, you need to open the language file as ASCII and remove the characters that are at the beginning of the file in front of <?php.
The backup section of the admin area allows you to export, import, download or delete a backup file. A backup file contains all data from the database including articles and settings.
When you click “Export Backup” the script will write all data into a file in the folder /cache/backup/. The file name consists of the date (ISO standard) and time of the export. The content is formatted in MySQL statements which makes it possible for you to import it using any other MySQL administration tool such as PHPMyAdmin.
If you want to import a backup, simply select the one you intend to import from the list and click “Import Backup”.
Attention: Importing a backup will delete (as in completely destroy) all existing data. It is advised to export a backup first.
This option allows you to save a local copy of the export file. This way you can upload the backup to your server in case of a full data loss including all files on your server.
This option will delete a backup file.
Please note: The admin account information (login name, e-mail address and password) are neither exported nor imported in order to make sure those information do not change unexpected when you work with backups.
Modules are small tools that are integrated into the script and add various kind of functionality.
These tools reside in the folder /modules/. Each module has its own language file and template file. You can find those files in the folders
/module/gentlesource_module_*/language/
and
/module/gentlesource_module_*/template/.
Not all modules are available for every script. For example, it makes no sense to include Captcha or flood protection to a script that has no user contribution capability such as commenting.
Please note: Some modules (i.e. Captcha, IP-Block) offer the option to moderate comments. Some scripts (i.e. Temporary E-Mail) do not support the moderation option, but only the rejection option.
By default most of the modules are not installed. In order to install a module, login to the admin area and open the configuration section. Click “Module Installation” to open a list with available modules.
Install and uninstall modules as you wish. You are also able to change the position in the list.
Akismet.com analyzes incoming comments and checks if that comment has been listed as Spam. You need to get an API Key from http://www.akismet.com/ by registering an account at http://www.wordpress.com/. If you leave this API key empty, Akismet will not be used.
The Captcha feature displays an image with a string of characters. In order to prove that the visitor is not an automatic spam program, he has to enter the characters shown in the image into a form field. In case both strings match the comment will be accepted.
Moderate or block comments based on the IP address of the visitor.
The module writes date, time referrer and request URI of a visit to a text file.
Enabling this feature will display a list with links to social services such as del.icio.us or digg below the page content. You can edit the list in the template link.tpl.html in the module folder.
Make money with your website and publish simple text link ads or buy text link ads to improve your traffic and search engine rankings. You can find more information at Text Link Ads: http://www.text-link-ads.com/?ref=37444.
In order to use this feature you have to register with Text Link Ads.
Make money with your website and publish ads from AuctionAds. More information at http://www.auctionads.com/refer_9ed4505eaeb7d99a79d6.
Publisher ID
You can find your publisher ID in your AuctionAds account. It’s listed on "Account Home".
Campaign ID
The campaign ID is a string of letters and numbers. It is not the text that you entered when you created the campaign. It is automatically generated by AuctionAds when you create a new campaign.
The campaign ID is not easy to obtain. In fact it is not shown in your Auction Ads account in plain text. There are two ways to find the campaign ID. Go to the campaign manager in your AuctionAds account. View the source text and look for the checkboxes. The value attribute contains the campaign ID. The other way would be – in Firefox – to view the page info. There is a tab named "Forms" that contains all form fields and values listed.
Keywords
AuctionAds has published some helpful information about keywords. You should really check them out, but in short: Separate keywords by comma, separate keyword groups by semicolon, put a minus sign in front of keywords you want to exclude.
Styles
If you are familiar with CSS, you can enter CSS code to format or position the ad block.
If you run into problems while installing or configuring News Script, please use our support forum on http://www.gentlesource.com/.