Before Starting: Check to make sure to ask your host if they have the PERL MODULE XML:PARSER installed. If it isn't installed, BlogBomb won't work.


Installation for BlogBomb and BBx2:

Check path to perl: #!/usr/bin/perl (Change if necessary)

Open /data/config.pl
 - Set the password:
 - $ADMIN_PASSWORD = "test";
 - URL to directory where BlogBomb is installed. This is needed so BlogBomb can generate the correct SSI tag for your pages:
 - $FEEDSEARCH_SSI_URL = "http://YourDomain.com/cgi-bin/blogbomb";

Upload all files and folders in ASCII/text

Set permissions:
 - blogbomb_admin.cgi - 755
 - feedsearch_ssi.cgi - 755
 - data.pl - 755
 - /data - 777
 - /data/cache - 777

 - /templates - 755
 - /XIT - 755
 - /libwww - 755



BlogBombXtreme!

Upgrade from Blogbomb to BlogBomb Extreme:


1 Open blogbomb_admin.cgi and feedsearch_ssi.cgi.

2 Check/change path to perl: #!/usr/bin/perl
 Change if necessary.

3 Upload in ascii/text

4 Upload/Overwrite:
 - blogbomb_admin.cgi
 - feedsearch_ssi.cgi
 - And /templates/ folder

5 Upload:
cover.html
main_ex.html


 
Upgrading to BBx2 (from either BlogBomb or BlogBombXtreme)

Note: BBx2 is compatible with all versions of BlogBomb, as well as GodfatherBomb, and your old tags will continue to function.

All of your old pheeds will be stored in a category called "DEFAULT".

1 Open...
blogbomb_admin.cgi
feedsearch_ssi.cgi

...in any text editor. It is recommended to NOT use NotePad. Use WordPad, also installed on Windows, instead.

2 Check/change path to perl: #!/usr/bin/perl
 If you don't know your path to perl, ask your host.

3 Upload in ascii/text

4 Overwrite Existing BlogBomb cgi files:
 - blogbomb_admin.cgi
 - feedsearch_ssi.cgi

5 Set permissions to 755 for two cgi files.

6 Upload new TEMPLATES folder, overwriting previous templates.


Add List Of Feeds (BlogBomb Xtreme Only): Use this option to include multiple feed URLs at one. This method is much faster, but doesn't have the descriptions and titles included in the "Your BlogBomb Feeds" output.

Your BlogBomb Feeds: Here's where the feeds you have entered into BlogBomb are displayed. If you used "Custom" method you'll see the titles and descriptions you used when you entered the feed. If you used the "Xtreme" method, you'll just basic info and the SSI tag.

If you have edited your config.pl file correctly (see above), BlogBomb will automatically generate an SSI tag for each feed. Simple paste this feed into a webpage and the contents of the feed will be added wherever you put the SSI tag.


Log into:
http://www.YourDomain.com/cgi-bin/blogbomb/blogbomb_admin.cgi

If you have an error, re-upload everything. There are many small files and one may not have completely uploaded.

Custom: Add New Feed - Here, you can enter info for any feed you find. Use this option if you want detailed info about each feed.

Enter the feed's title, remembering to both use good keywords and give the publisher credit.

Enter a description. This is for your use and won't appear in your pages.

HTML URL: This is the URL that if a feed is clicked the surfer will be sent to. This is for your

XML URL: The URL of the feed itself. Just paste in the URL.

Note: The XML URL is the only one that really matters. The other entries are for your own info and do not affect BlogBomb.

There are many resources for finding great URLs for feeds. Please visit the forum for all the latest news and feeds.

http://dombomber.com


Using SSI to include selected feeds on your pages:

BlogBomb will generate a default SSI tag for each feed you select. You may set the default number of feeds in the data/config.pl file.

You can simply paste a default tag into your html document. For example:

<!--#include virtual="/cgi-bin/blogbombx/feedsearch_ssi.cgi?channel=user-1.xml" -->

You may also control your results by using the following attributes in the SSI tag:
&results=5


For example:
<!--#include virtual="/cgi-bin/blogbomb/feedsearch_ssi.cgi?channel=user-5.xml &results=5" -->

Also, there is a "random" attribute that will randomly insert various feeds from your selected feeds.

<!--#include virtual="/cgi-bin/blogbomb/feedsearch_ssi.cgi?random=1&results=4" -->

Random is a very powerful feature. Search engines don't like duplicate pages.

By creating your own custom mixture of feeds, then adding the ability to display these feeds at random, all but ensures you will have a unique combination of feeds, giving your pages "one of a kind" content.

Note: To display results using SSI tags, you will either need to name your pages .shtml or use an .htaccess file. .htaccess files are simple to use. For more information on .htaccess, please visit:

DomBomber Forum.
 

New Features for BBx2

Note: BBx2 is compatible with all versions of BlogBomb, as well as GodfatherBomb.

All of your old pheeds will be stored in a category called "DEFAULT".

Categories - BBx2 allows you to organize your pheeds by category, with out having to install new instances of BlogBomb. To create a new category, click the "Main" link and enter the appropriate information.

- Title - Give your new category a name.

- Description - Enter some information to help describe the category.

- Cache - All versions of BlogBomb use a "cache". This means BBx2 doesn't need to contact an outside host or server every time BBx2 wants to display content. Instead, BBx2 stores this content in a "cache". The amount of time you set in the cache tells BBx2 how often to check for updates.

In BBx2, you can determine the cache time, or how often BBx2 checks for updates for EACH category. This greatly impacts the efficiency of your web business, by allowing you to chose different cache times for each category.
1 Hour = 3600 seconds
12 Hours = 43200 seconds
1 Day = 86400 seconds
1 week = 604800 seconds
4 weeks = 2419200 seconds

An example could be that you have one source of pheeds that gives you quality, but their server is often down. In BBx2, you can create a category just for that resource, filling it with multiple pheeds, then set the cache time higher, so the BBx2 doesn't have to contact the server nearly as often.

Templates - Every category you create allows you to use a different format telling BBx2 how to display your pheeds on your pages. Each template must contain three tags, in red below...

<a href="{url}">{title}</a><br>{description}<br>&nbsp;</br>

The bit of code above is a good, simple and basic template for most general uses. If you want to use this template, just paste the string of code above into the Template form in your Admin. Of course, if you know HTML, you can play around with it by changing fonts, text color, size, etc.

Deleting Categories - Categories can only be deleted if there are no pheeds installed in the particular category. This is a safety measure to ensure you don't delete pheeds accidentally.

To delete all the pheeds, you can click the very top CHECKBOX, which will select all the pheeds, the click "DELETE SELECTED PHEEDS".

Once all the pheeds have been deleted and the page refreshes, you will see a button that says "DELETE EMPTY CATEGORY". Click it, and that category will be deleted.

Add a list of pheeds to Xtreme. BBx2 automatically extracts title, description, HTML url and the RSS url. There is no need to do this by hand any more. However, you can still use the CUSTOM "Add RSS Pheed" if you want more control over titles and descriptions.

Generate Special SSI Tag - You can now use a wide variety of tags to give you more power to put content on your pages. In addition to being able to use individual pheeds, as in previous versions of BBx2, you know have the powerful option of using pheeds by searching by keywords.

 - Pheeds: All pheeds or Individual pheed (select one). If you select ALL, BBx2 will search ALL the pheeds in that category, and display results based on that keyword(s). You may also limit your search to a particular pheed.

 - Keywords: Simply enter your keyword or phrase.
 - Search Mode: All : Any : Exact
 - All : All of the words, in any order, must be present in an ITEM for that ITEM to be displayed.
 - Any : Any word must be present. If you have a four word phrase, if ANY of those four words are contained in an Item, then that Item will be displayed.
 - Exact : The phrase must appear EXACTLY AS TYPED into the search box.

"Any" will return the most results, but be the least relevant, while "EXACT" will return the least results, but will be the most relevant. "All" is somewhere in the middle.

Other Changes in BBx2.

The numbering system has changed. If a pheed is deleted, the next pheed created takes the deleted pheeds number. For example, if you have 10 pheeds numbered 1-10 and delete #5, the next pheed created will be numbered #5, not #11 as in past versions of BlogBomb.

Common Mistake: Make sure your data/config.pl file points correctly to your BBX2.

It should be similar to:
"http://YourDomain.com/cgi-bin/blogbomb";.

 
Final Thoughts -

Don't let the tech stuff get to you. It can be learned step by step. The key to long term success is the ability to find good and profitable content. The Bombers that make the most money are NOT the most technically advanced. But, they are the ones that stick to it.

There's tons of creative ways to use BlogBomb for fun and profit. Please check the Forum often for the latest resources, pheeds, tips, secrets and strategies...

DomBomber Forum

Thanks, and see you at the Forum.

- Kurt Melvin