Integration with vBulletin - CFM: Google AdSense for Search Integration

Title: "CFM: Google Search Results"
-------------------------------------------------
Author: Sal Bezos (webmaster@carforummisfits.com)
Date of Creation: September 3, 2006
Version: 1.0 (9/30/2006)
Home: http://www.carforummisfits.com/
-------------------------------------------------

Purpose:
--------
This product for vBulletin creates a target page for providing Google Search Results within your vBulletin forums. The Google Search Results (AdSense for Search) will appear in a vBulletin page.

Unlike the previous revision of this product, you will now be able to enter code for a Google Search Box for placement in the Search drop-down menu (or anywhere else you would like to place it). Please make sure that your search box code includes a <form> tag that states something along the lines of action="http://<yourhostname>/forums/cfmgoogle.php".


Tested:
-------
This product has been tested on a vBulletin 3.6.1 installation. There is no reason why it should not work in the same manner on any 3.6.x or 3.5.x installation, but it has not and will not be tested by the author.


Included Files:
---------------
- README.txt
- cfm-live-demo.png (screenshot)
- cfmgoogle.php
- product-cfm_google_search_results.xml


Installation:
-------------
1. Upload the cfmgoogle.php file to your forum root, usually located at http://<yourhostname>/forums.

2. Register for a Google AdSense for Search account.
----a. Register for a Google AdSense account if you don't have one.
----b. Visit "http://www.google.com/adsense/".
----c. Login with your e-mail and password.
----d. Click on the "AdSense Setup" tab.
----e. Select "AdSense for Search".
----f. Configure your search box.
--------f1. Select either "Google WebSearch" or "Google WebSearch + SiteSearch" depending on whether you want users to be able to Google search your site or not. If you select "Google WebSearch + SiteSearch", enter the URL of sites you wish to be able to search.
--------f2. For Logo Type, I recomment selecting "Google Logo" and checking the "Logo above text box" option.
--------f3. For "Opening of search results page" select "Open results within my own site." Enter the URL of your cfmgoogle.php file (e.g. http://<yourhostname>/forums/cfmgoogle.php)
--------f4. Click "Continue >>".
----g. Configure the appearance of the results page, then click "Continue >>"
----h. You should now receive two sets of code from Google labeled "Your search box code" and "Your search results code".

3. In your forum's admin panel, go to Plugins & Products/Manage Products

4. Click on Add/Import Product

5. Click "Browse..." and select the "product-cfm_google_search_results.xml" product file. If this is your first installation of this product, select the "No" radio button in the "Allow Overwrite" option. If you are upgrading or reinstalling, select the "Yes" radio button. Click the "Import" button.

6. Go to vBulletin Options/vBulletin Options. Scroll through the list and select "CFM: Google Search Results".

7. In the "Google Search Box Code" option, paste the code provided by Google titled "Your search box code".

7. In the "Google Search Results Code" option, paste the code provided by Google titled "Your search results code".

8. In Styles & Templates/Style Manager go into Edit Templates for your style. Open the "Navigation / Breadcrumb Templates" template group and open the "navbar" template.

9. Find the following:

		<form action="search.php?do=process" method="post">
		<table cellpadding="4" cellspacing="1" border="0">

And replace with:

		<table cellpadding="4" cellspacing="1" border="0">
		<form action="search.php?do=process" method="post">

Find the following:

		</table>
		</form>
	</div>
	<!-- / header quick search form -->

And replace with:

		</form>
		<tr>
			<td class="thead">Search Google</td>
		</tr>
                <tr>
                        <td class="vbmenu_option" title="nohilite">$vboptions[cfmgsr_googlesearch]</td>
		</tr>
		</table>
	</div>
	<!-- / header quick search form -->

10. Pull up a forum page and look under your search drop-down menu for the search box.

11. Enjoy!


FAQ:
----
Q. My search results window is too tall. What's wrong with it?
A. This appears to be a bug in the Google Search Results code. If my assumption is incorrect, please let me know.

Q. Why are the colors all wonky on my search results?
A. The colors of the search results are provided by the search box. Make sure the colors in the search box code are correct.

Q. The background color of the Google search box doesn't match my page -- what can I do about it?
A. If Google's TOS allows it, play around with the settings in the code you pasted in the "Your search box code" option.


Revisions:
----------
1.0 - 09/30/2006 - Adding instructions and support for the Google search box in the search drop-down menu
0.1 - 09/03/2006 - Initial release


Support:
--------
Any questions and problems should be reported to the modification's thread on http://www.vbulletin.org. No warranty, express or implied, is granted with this software. Use is at your own risk.


License:
--------
GNU GENERAL PUBLIC LICENSE
Version 2, June 1991

[Throtex]

Revision 1.0 of this product supports installation of the search box. The VB-savvy among you will quickly realize you can just take the $vboptions[cfmgsr_googlesearch] variable and place it wherever you like. The search drop-down menu integration is just an example.

--

Upgrading from 0.1 to 1.0: Just install the new product -- php file is identical to the old one.

[Brandon Sheley]

hows this different from the one that is already made just like this ?

[Throtex]

Originally Posted by Loco.M

hows this different from the one that is already made just like this ?

I'm not sure which one in specific you're talking about, but this integrates the results page into your forum, rather than the search box.

What's the link to the other plugin?

[Throtex]

This is different from any of:
https://vborg.vbsupport.ru/showthread.php?t=103222
https://vborg.vbsupport.ru/showthread.php?t=116013
or
https://vborg.vbsupport.ru/showthread.php?t=104832

because this integrates the RESULTS page into the forum. You will need to use a hack like one of the aforementioned in order to create an integrated search box that will link to the integrated page in this hack.

[WritersBeat]

Thanks, looks interesting.

[KevNJ]

Just tried it on your site. I like it. Will be installing once I get home, Im currently at work and "working". hehe

[Throtex]

Originally Posted by KevNJ

Just tried it on your site. I like it. Will be installing once I get home, Im currently at work and "working". hehe

Thanks!

[voteforbird]

Great add-on. Also, I was able to do it, but you may want to include directions about how to install the search form on the three floating DIV search boxes.

[KevNJ]

*clicks install*

works great. Just gotta make the drop down box more fluid to match the google search boxes.

Never used google adsense for search before... does it pay when someone does a search for something.. or after they do a search and click on a link from the results ?