BJC Computer Services
 
  HOME PHP Scripts... 
 

Article Import Scripts
for Article Dashboard

 

Setup and Configuration
Options

Download Article Submission Test Forms

 

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...