Description:
The following user options are available, to
control import of
article posts from iSnare or Article Marketer into
your Article Dashboard MySQL Database. Each user configuration option
is explained below.
Not all options are available for all script versions.
Exceptions are [ noted ] in the option description.
To DISABLE any option
- Set value =
false;
To ENABLE - Set value = true;
User
Options
Database access parameters are
retrieved from the Article Dashboard 'setup.php' file in the
root file directory. You should first verify the file exists, and
that it contains
accurate database access instructions before proceeding. Our script
files will not execute without the Article Dashboard setup.php file.
Option -
Test Mode
This option is provided to allow script testing by the
owner. If you need to test your script, then you must Enable
this option. By default,
the import script will restrict incoming access to iSnare or Article
Marketer servers.
Script execution will halt if an access attempt is made from any
other host. If you want to completely
remove the access restriction, leave the option set to Enable.
NOTE: If you receive an error
Invalid Host - Access Denied during access or testing, change this value to true
in order to bypass originating host validation.
- Enable:
$test_mode
= true;
- Disable:
$test_mode
= false;
Option -
View Test mode Progress on Screen
This option
defines how script activity messages are displayed when
using test mode. When this option is Enabled, all script
activity is displayed on-screen. When Disabled, the screen
output is suppressed. The messages are identical to messages
stored in the logfile, if the logfile is enabled.
- Enable:
$view_test_mode_progress_on_screen
= true;
- Disable:
$view_test_mode_progress_on_screen
= false;
Option -
Log activity
This
option allows script activity to be captured to a
log file. This information is useful for monitoring incoming
article receipt and for trouble isolation. Enable this
option to record the log file. Disable this option if a
log file is not required.
- Enable:
$log_activity
= true;
- Disable:
$log_activity
= false;
Option -
$logfile
This
configuration option provides the directory and filename to be
used for the script log file. This must be a valid
directory and file write access must be granted. If the
$log_activity option is disabled (false), the $logfile option is
not used.
NOTE: If you receive an error when
accessing your script -
Warning: fopen(cgi-bin/article_log.txt) [function.fopen]: failed to
open stream: it means the logfile could not be written. Check the $logfile option to ensure the
/cgi-bin/ directory is valid and that write access is enabled in that directory.
- $logfile = getcwd()."/cgi-bin/article-log.txt";
Option -
iSnare Link Add
[ iSnare Only ]
This
option enables the web site owner to automatically provide a URL
back link to iSnare. This option is provided for user
convenience only!
- Enable:
$isnare_link_add
= true;
- Disable:
$isnare_link_add = false;
NOTE: Adding a back-link to iSnare is NOT a requirement to receive
articles via distribution.
Option -
iSnare Link Location
[ iSnare Only ]
If the iSnare Link Add option is set to Enabled (TRUE), this
option allows the user to select the location for link
placement.
There are two available options: Append to Author
Bio, or Append to Article.
- Example:
$isnare_link_location
= "Author Bio;
- Example: $isnare_link_location
= "Article";
Option -
iSnare Link Text
[ iSnare Only ]
If the iSnare Link Add option is set to Enabled (TRUE), this
option allows the user to select the text displayed when the
link is added.
- Example:
$isnare_link_text
=
"source: <a href=\'http://www.Isnare.com\'>www.Isnare.com</a>";
Option -
Enforce Titlecase
This
option allows the script to analyze the article title content,
and to make changes to enforce proper title case.
- Enable:
$enforce_titlecase
= true;
- Disable:
$enforce_titlecase
= false;
Option -
Auto approve new articles
This option determines if a new article title should be
automatically approved during the import process. Enabling this
option will automatically approve any article that passes the
check for duplicate title. If you do not
wish to approve new articles during this import process, disable
this option.
- Enable:
$auto_approve_new_articles
= true;
- Disable: $auto_approve_new_articles
= false;
Option -
Import Text or HTML Article [
iSnare Only ]
This
option determines if the TEXT or HTML data field will be
imported from iSnare to the article dashboard article body
field. The directory owner must
select which format will be imported.
- TEXT:
$import_text_or_html_article
= "text";
-
HTML:
$import_text_or_html_article
= "html";
NOTE:
Article Marketer delivers TEXT or HTML format based on the
option chosen when signing up for article delivery. Format
changes must be resubmitted to Article Marketer.
Option -
Import Text or HTML Bio [ iSnare Only ]
This
option determines if the TEXT or HTML data field will be
imported from iSnare to the article dashboard article
resource field. The directory owner must select which format
will be imported.
-
TEXT:
$import_text_or_html_bio
= "text";
-
HTML:
$import_text_or_html_bio
= "html";
NOTE:
Article Marketer delivers TEXT or HTML format based on the
option chosen when signing up for article delivery. Format
changes must be resubmitted to Article Marketer.
Option -
Add Imports to Ezine Notification
This
option determines if articles that are imported and approved
by this script will be added to the newpost table for real-time and weekly
Ezine Notifications. If you wish to notify users when new
articles are imported and approved by this script, set this
option to ENABLE.
-
Enable:
$add_imports_to_ezine_notify
= "true";
-
Disable:
$add_imports_to_ezine_notify
= "false";
Option -
Enforce Word Count
This option allows the site owner to check for minimum
and maximum word counts for articles. When this option is
Enabled (true), the script will count the number of words
and reject any article that does not meet the requirements
specified by the Minimum Word Count or Maximum Word Count.
- Enable:
$enforce_wordcount
= true;
- Disable: $enforce_wordcount
= false;
Note: When the word count is performed, the article
text is copied to a temporary variable and stripped of HTML
tags before the actual word count is determined.
Option -
Minimum Word Count
When the Enforce Word Count option is enabled, this
option will determine the minimum number of words allowed
for import. Specify the minimum number of words to be
allowed in the article text.
Note: Setting this value to zero (0) will result in
minimum word count being ignored
- Example:
$min_word_count
= 600;
Option -
Maximum Word Count
When the Enforce Word Count option is enabled, this
option will determine the maximum number of words allowed
for import. Specify the maximum number of words to be
allowed in the article text.
Note: Setting this value to zero (0) will result in
maximum word count being ignored
- Example:
$max_word_count
= 1200;
Option -
Auto Approve New Authors
When a new author record is received, this option determines
if the author will be automatically approved during the database
import process.
- Enable:
$auto_approve_new_authors
= true;
- Disable: $auto_approve_new_authors
= false;
Option -
Default Image
If you have a
default image you would like to use for authors who have not
supplied a photo, you can supply the default image name in
this option. The default image must be stored in the /photoimages
directory. When a new author and pen name are created,
this image will be used in their profile.
If you do not
wish to supply a default image, leave the field blank.
Examples:
- $default_image =
"YourImageName.jpg"; [ to use a default image ]
- $default_image
= "";
[ leave the image blank ]
Option -
Enable Author Block
Enabling this option will allow specific authors to be
skipped over during the article import process. If you
have authors who consistently submit low quality articles,
Enable the author block to bypass importing those articles.
- Enable: $enable_author_block = true;
- Disable:
$enable_author_block
= false;
Option -
Author Block Array
When the Enable Author Block option is set to TRUE, the
authors in this Array will be excluded during the article
import process. Any article received from these
authors will be flushed (ignored).
Sample Array:
$author_block_array = array (
"email1@domain.com",
"email2@domain.com"
);
Note:
For Article Marketer Authors, you must provide the authors email address
For iSnare Publisher Authors, you must supply the Author Name (Pen Name)
Option -
Check for duplicate title
Enabling this option will initiate a search for a duplicate
article title when an article is received. If a match is found,
the article title is flagged as a duplicate (within the
script) and the script continues processing. This duplicate
title flag is used by later script processes.
This feature has been enhanced to include Article Title,
Author ID, and Pen Name ID before declaring a duplicate.
- Enable: $check_for_duplicate_title = true;
- Disable:
$check_for_duplicate_title
= false;
Option -
Import duplicate title
If an article has been flagged (in the previous step) as being a
duplicate title, this option will determine if the article is
imported. If you wish to import the duplicate title anyway,
ENABLE this option. If you do not wish to import the duplicate
title, set this option to DISABLED and the duplicate title will
not be imported.
- Enable:
$import_duplicate_title
= true;
- Disable: $import_duplicate_title
= false;
Option -
Auto approve duplicate title
If a duplicate title is flagged and approved for import as a
result of the previous options, this auto approve duplicate
title option will determine if the imported article is
automatically approved during import.
- Enable:
$auto_approve_duplicate_title
= true;
- Disable: $auto_approve_duplicate_title
= false;
Option -
Replace Original
If a duplicate title has been flagged, enabling this
option will allow the script to overwrite the pre-existing
database record. All content fields including the
original posted date are overwritten with the new article
contents. This option is provided so that Authors who
resubmit their article (with the same title) to provide
updates or corrections to the original content.
If this feature is Disabled, normal duplicate handling
will occur, as specified by the options above.
- Enable: $replace_original
= true;
- Disable: $replace_original
= false;
Option -
Article Aging
This option works in conjunction with the Replace
Original option above. If Replace Original is Enabled, the
script will determine how old (in days) the original
duplicate article is.
If the original article is older then the number of days
specified by the Article Aging value, the article will be
replaced. Otherwise, normal duplicate handling is enforced.
- Example: $article_aging
= "1";
Usage Tip:
In the example value above, if the original article is
equal to, or greater than, 1 day older, it will be replaced.
Option -
Create new categories
This option will instruct the script to create a new category to
match the requested category in the article post. The script will first
scan your existing article dashboard database for a pre-existing
match. If a category match is found during the scan, the
existing category will be used. If a match is not found, a
new top level category will be created.
- Enable:
$create_new_categories
= true;
- Disable: $create_new_categories
= false;
Option -
Use Category mapping
Category
mapping allows you to place incoming articles into an
existing site category. If you want the article placed into
a different category than submitted, use the category map to
redirect the article to a different category.
When category
mapping is Enabled, new articles are imported to the
categories which you have defined in the category map.
Incoming categories which are not listed in the category map
are not modified.
- Enable:
$use_category_mapping
= true;
- Disable:
$use_category_mapping
= false;
When category mapping is Enabled, you must also update the
$category_map array in the script setup to reflect your mapping requirements.
In the sample provided in the script:
original_category1 -
The category contained in the article post
mapped_category1
- The category to use in your directory
Change those sample values to match your actual category names. You can map as many categories as required
by simply inserting additional lines. Use the same line
structure as the samples provided. Use separate lines for each category, and end each new line with a comma (,) except for the last line in the map (no comma).
Note:
iSnare supplies the individual category name in the article post
- example: Loans
Article Marketer supplies the category in a tree format -
example: Finance/Credit/Loans
To view the category list from iSnare:
- Log into your publisher account at
http://www.isnare.com/publisher/
- Select Settings from the top menu
To view the category tree list from Article Marketer:
- Access
http://www.articlemarketer.com/posted.php
- Select category list from the Quick Tips menu on the left
Option -
Use Keyword Mapping
Enabling this option will allow keyword screening and
mapping, for articles to be screened
and selectively sent to a predefined category. If you would
like specific articles containing specific keywords or
phrases to be mapped to specific categories, this option
should be Enabled.
- Enable: $use_keyword_mapping = true;
- Disable:
$use_keyword_mapping
= false;
Option -
Keyword Map
If the Use Keyword Mapping option is Enabled, the Keyword
Map array is used to route articles containing specific
keywords to an existing mapped category in your article
database.
This option is similar to other mapping options available
in the script.
Sample Array:
$keyword_map = array (
"Keyword1" => "Category1",
"Keyword2" => "Category2",
"Keyword3" => "Category3"
);
You can add as many keywords or key phrases as needed by
copy/pasting a new line. Each line must end with a comma,
except for the last line (NO comma). Only the keyword field
in the article post is examined for a match. The script does
not search titles or article body.
Example:
Keyword1 -
The article keyword or phrase to search for in the
keywords field
Category1
- The Article Dashboard category to receive the articles
Option -
Email to Blog
Enabling this option will allow articles to be screened
and selectively sent via email to your Blogger.com or other
email address. Article categories or Keywords must be
specified in the emailtoblog_category_map or
emailtoblog_keyword_map for this action to occur. The Author
bio and article keywords are appended to the bottom of the
article content.
- Enable: $emailtoblog = true;
- Disable:
$emailtoblog
= false;
Usage Tip:
The Email to Blog feature is mainly targeted to users who
maintain a small niche blog, and wish to augment the content
feed.
Option -
User Email From
This text field is provided for use in the email header
for articles sent via the email to blog feature.
Specify the FROM name to be included here.
- Example:
$useremailfrom
= "Your Article Site";
Option -
User Email Address
This text field is also provided for use in the email
header for articles sent via the email to blog
feature. Specify the email address from which the article
will be originated. This field is required by some email
Spam filters.
- Example:
$useremailaddress
= "webmaster@yoursite.com";
Option -
Include About the Author
This option specifies if the "About the Author Text"
below will be included above the author bio, when the
article is sent by the email to blog feature. If this option
is Disabled, the phrase below will be excluded.
- Enable: $include_about_the_author = true;
- Disable:
$include_about_the_author
= false;
Option -
About the Author Text
This is the text that will be appended to the article,
above the Author bio, for articles sent via the email to
blog feature. This option is provided to allow the script
user to customize the display text.
- Example:
$about_the_author_text
= "About the Author:";
Option -
Email to Blog Category Map
When the Email to Blog feature is Enabled, articles
received in the categories specified will be sent via email
to the email address specified in the map. If the article
category is not listed in the map, the article will not be
sent.
Sample Array:
$emailtoblog_category_map = array (
"iSnare category1" => "email_address1",
"Article/Marketer/Category1" => "email_address2",
"iSnare category3" => "email_address3"
);
Example:
iSnare category1 -
The iSnare category contained in the article post
email_address1
- The email address to receive the articles
Option -
Email to Blog Keyword Map
When the Email to Blog feature is Enabled, articles
received with the specified keywords will be sent via email
to the email address specified in the map. If the article
keyword is not listed in the map, the article will not be
sent.
Sample Array:
$emailtoblog_keyword_map = array (
"Keyword1" => "email_address1",
"Keyword2" => "email_address2",
"Keyword Phrase" => "email_address3"
);
Example:
Keyword1 -
The article keyword contained in the article post
email_address1
- The email address to receive the articles
Disclaimer: Test this script thoroughly under your
unique server configuration
before using in a live traffic environment. For questions, assistance, or
suggestions:
Email:
support@bjc-computer-services.com
Forum:
http://www.bjc-computer-services.com/forum/
Important:
For script security, the following entry should be added to your
robots.txt file in
order to exclude the import script file from search engine indexing.
User-agent: *
Disallow: /YourScriptName.php
Return to the
Article Dashboard PHP Scripts page...
