Promote items from certain domain to top of first page from all results.

Hi,

Attached to this you have the code that searches through the result xml and reorders the search results based on the number of items that come from a certain domain name (both the number and domain name are set in the function) .

-- WHY WAS IT CHANGED --

The customer wanted to have the ability of promoting to the top of the first search page results that come from a certain domain. The "out-of-the-box" module functionality did not support such a feature, therefor a custom implementation had to be done

-- WHAT WAS CHANGED --

Added variables and explanation
- $promoted_items_to_top_of_search - integer : number of promoted items to be placed at the top of the first search page (currently set to 5)
- $promoted_items_domain_name - string : items to be promoted to the top of the first search page will be fetched from this domain name on a first occurrence basis

- $promoted_results - empty array : temporary array that will hold the information of promoted items found from search result.
- $occurrence - integer : counter used to determine the number of currently found items that are to be promoted

Background information
- the google_appliance_parse_device_response_xml parses a raw xml coming from google_appliance_search_view

google_appliance.module : added logic starting at line 472
- the 3 conditions of the IF statement explained :
- check if the current item was fetched from the promoted_items_domain_name. The format of the url is always "http://www.some-domain-name.fi", therefor we check only for "some-domain-name" by excluding the "http://www." part of the string and continue the comparison by the length of $promoted_items_domain_name. If the values are matched, we have a winner. AND
- we make sure that we do not exceed the number of $promoted_items_to_top_of_search by comparing it to the $occurrence counter. AND
- we check if we are on the first page. 2nd, 3rd ... Nth search pages have the "?page=n" argument attached to the url and the first page doesn't, so we check for it.

- once all 3 conditions are met :
- the $occurrence gets incremented
- we add the result's domain ($result['result_domain']) to the result array (to be used later, read on)
- we store the result in the $promoted_results['entry'] array

- if any of the 3 conditions are not met :
- the result is either not coming from the domain name, either we already have the required no of $promoted_items_to_top_of_search, either we are not on the first page of the search result
- add the result array to the $results['entry'] array

- after we have gone through all of the raw xml we check for if the $promoted_results exists
- if it does => we have results that need to be at the top of the search page and we merge the $promoted_results with the (non-promoted) $results
- if it doesn't => the proverbial "sh*t happens" and we move on

- return the $results array

This is by no means a generic solution but could be if somebody has the time to do it. The attached function can be a starting point.

This is my first ever contribution to anything related to Drupal so whip me 'til I bleed because I haven't done this properly.