Location: PHPKode > scripts > Mini-Fetch > readme.txt
Thank you for purchasing Mini-Fetch!
Your requests for improved features in MiniFetch, your feedback, and your questions are all important. 

Upload and use right away, or drop into your own HTML (saved as a PHP File) and start using. Detailed instructions below. 

Trouble with fidgety content retrieval? It's covered in the FAQ below, but if you've read the FAQ and are still convinced it's not your fault, you can make contact at: 

http://www.webmedic.co/contact.php
Responses are usually quick.

CONTENTS of this file. 
1. Description
2. Copyright Notice
3. Requirements
4. Installation instructions
5. Frequently Asked Questions
6. Legal Disclaimer

1. Description of MiniFetch:
	-Retrieves remote content from almost any website
	 or search engine (even URL's with odd characters like
	 ?'s or &'s in them) 
	-Updates the page content every time a surfer loads the page
	 (major time saver for webmasters) when you fetch from SE's (engines)
	-strips and/or replaces HTML tags or phrases you specify
	-Reformats content to match your own site

	
2. COPYRIGHT NOTICE:
Purchasing MiniFetch gives you a single user license to use it on ONE domain over and over as often as you like including subdomains. If you have multiple URL's where you wish to use it, you can contact me for a major discount on every license after the first. 
This code is copyrighted by MikeNew.net, 2002. After having purchased MiniFetch, you may freely edit the code for your own use on your domain, but you may not distribute the code or any derivative works thereof for free or for profit without my express consent.

3. SYSTEM REQUIREMENTS:
	A website. Yours!
	An Windows IIS/NT or Unix server. It matters not. MiniFetch is cross-platform.
	FTP access to your site. (or some way to upload the files!)
	PHP 4 must be available on your server, and the file using minifetch must be parsed as a PHP file..

 What you do NOT need: 
	a database
	the ability to change read/write permissions
	

4. INSTALLATION INSTRUCTIONS (2 SIMPLE STEPS):

(Important! You really should use a text editor or HTML editor other than something like MS Frontpage or MS Word. Use Notepad or Notepad++ or something similar. Dreamweaver works well, too.)

  	STEP 1.) Unzip the package into a directory on your hard drive to a folder. Included in the folder are working examples of MiniFetch. They may be renamed and/or uploaded to your website and used immediately.

  	STEP 2.) Open one of the working examples of minifetch.php.  There are many variables you can change in the minifetch.php file, but only three are mandatory: 
	1)The URL (or path to local file) of the content your are fetching.
	2)The unique starting point in the HTML (where it starts fetching)
	3)The unique ending point in the HTML (where it stops fetching)

If the UNIQUE HTML you're using has quotation marks therein, don't forget to "escape" them, with a slash, like this:
If the HTML is:  <img src="images/something.jpg">
You would tell MiniFetch: <img src=\"images/something.jpg\">


If you like, you can edit other variables within the file to strip out HTML tags like <td> and <li>, or even text like a competitor's name.

OPTIONAL: 
If you'd like to use MiniFetch in an existing page, you can either paste the code of a working minifetch file directly into your HTML file (that's saved as a PHP or PHTML file), or, wherever you want the content to appear in your page, just type the following: 

	<? include("minifetch.php"); ?>

The above  command assumes minifetch.php is in the same directory as the page.
Otherwise it could be:

<? include("../path/to/minifetch.php"); ?> 
or
<? include("http://www.yoursite.com/folder/minifetch.php"); ?>



5. LEGAL DISCLAIMER:
By using MiniFetch, you assume full legal responsibility for any actions which might occur by your use of the script. This script was originally created to save you time so you only have to update a few of your files, and the rest will automatically update with it. You should ask any website owner before you "fetch" their page content, in order to avoid copyright issues. Although MiniFetch has been extensively tested on different servers under different conditions, by using this code, you assume full responsibility for any software or code error or damages which may arise. 


6. FAQ's (Frequently Asked Questions)

Q) I've installed MiniFetch, and used the "include" command to grab content to my page, but the output is either non-existent or haywire! Why?

A) 99% of the time, it's one of two or three things: 
 
 1) The $start or $finish point that you specified in the HTML was not UNIQUE.
 A $start or $finish point of <b> would not work well typically, because there are so many <b> tags in a page. Something like <b>Results:</b> would probably work, however.

 2) The other problem people sometimes have is entering neglecting to strip certain HTML tags from the content they've retrieved.  The option to strip certain HTML tags is contained within the script, and documented in a manner that's easy to understand. Just open minifetch.php with your text editor read the brief instruction details. You can be stripping those tags and replacing them with your own within less than a minute. And you only have to set it up once!
Remember, one of the best tags to strip is <td> and <tr> .

3. It also could be that you didn't put a \ in front of any " which appears in the unique starting or ending HTML.


Q) How do I know where some unique HTML is in a remote document or URL?

A) If it's viewable in your browser, then right-click in the page and then left-click "View Source." Or do it from the file menu - View --> Source.
Then, look for a spot in the page which looks like one of a kind, for example:
<p align="left"> <font size="1">News from today:</font></p>
That would be a great $start point. Do the same for your $finish point.
Tip:  Frequently, content you want to grab is surrounded in a side menu or table all on it's own. That's a great place to find unique HTML points, with tags for example, which might be something like <!-- menuLeft -->.  

Q) I don't want to install this myself. Will you do it for me?
A) Yes, for a small fee. Just contact Webmedic.Co/contact.php with details of your situation.

Q) My questions weren't answered! Now what?
A) Contact WebMedic from www.webmedic.co/contact.php

Thank you purchasing Mini-Fetch. 
Return current item: Mini-Fetch