Allows health and human service WordPress websites the ability search community resources utilizing the Resource House URL structure.
In June 2016 Revation Systems updated the Washington State 2-1-1 Community Resources Directory to the newest version of Resource House Public Portal. This new search engine utilizes a new and enhanced underlying api which allows for a variety of search keywords, taxonomy terms, location data, and feature filter options.
This plugin was developed to allow community resource and health and human service websites running WordPress to easily add a search form to their websites.
The plugin offers the following features:
- Shortcode
[win211search]adds a form to any Wordpress Page or Post - Form includes an autofill keyword search, autofill location, and search button to execute the search
- Plugin converts any link following the specified format (see Usage section) with location data
- Download 'win211-search-plugin.zip' from https://github.com/cderenburger/win211-search-plugin
- From the Plugins menu in your Wordpress Admin area select 'Add New' and press the 'Upload Plugin' button and upload the .zip
- Alternately extract and upload 'win211-search-plugin' folder to the '/wp-content/plugins' directory
- Activate the plugin through the 'Plugins' menu in WordPress
To add a basic search form to your Wordpress based site add the following shortcode to a page or post.
[win211search]
This will create a basic form where a user can enter a keyword search, set their location, and a search button to initiate the search.
Shortcodes cannot be used in sidebars or as widgets without the use of other plugins. Instead of using the shortcode, you can add a keyword and location search form to a sidebar or other locations. Place a Text Widget into your sidebar and include the following html code.
<form id="211-keyword" name="211-keyword" action="wp-content/plugins/win211-search-plugin/public/php/211search_keyprocess.php" method="post" target="_new" method="get">
<input id="taxname" name="taxname" onclick="this.value='';" type="text" name="keyword" value="" placeholder="What are you looking for?" maxlength="30" />
<p><input type="text" name="city" id="city" value="" placeholder="Location" />
<input type="text" name="geocoor" id="geocoor" value="" />
<input type="text" name="region" id="region" value=""/>
<input type="submit" value="Search" id="search">
</form>
There are two type of links commonly used for resource searches, Keyword and Taxonomy. Keyword searches are performed by Solr which will search based on default settings set by the site administrator. Settings described in the Solr section.
Resource House uses the following url structure to query the database based on the user's entered keyword(s)
https://www.resourcehouse.info/win211/Search?q={KEYWORDS}
Above is the minimum required to create a working link. A single keyword or series of keywords are placed in the {keyword} section and the site can perform a search.
The above example does not require this plugin to operate, but it's usefulness is limited and therefore not recommended . This link will search for the specified keyword(s) statewide.
The following link example is the expected format, requires use of this plugin, and will allow a user to enter their search location.
<a href="https://www.resourcehouse.info/win211/Search?q=Dental+Care" target="_blank"
data-relativeurl="Dental+Care">Dental Care</a>
The data-relativeurl= restates the keyword search. When a location is selected in the [win211search] location form this plugin reassembles the url consisting of the city and zipcode, geocoordinates, county, and the data-relavtiveurl=.
Additional paramaters can also be applied to searches. Examples given in the Feature Filters section.
The site can also perform more specific searches based on the AIRS Taxonomy. Use the taxonomy code in the following url format
https://www.resourcehouse.info/win211/Search/Topics/{TAXONOMY_CODE}/{TAXONOMY_NAME}
Taxonomy links require the Taxonomy Name following the Taxonomy Code. The link can most easily be obtained by visiting https://www.resourcehouse.info/win211/Topics and drilling down or by visiting https://www.resourcehouse.info/win211/Topics/{TAXONOMY_CODE} and copying the specified url from the Topic List.
Below is an example of a taxonomy search for Dental Care
<a href="https://www.resourcehouse.info/win211/Search/Topics/LV-1600/Dental_Care" target="_blank"
data-relativeurl="LV-1600/Dental_Care">Dental Care</a>
NOTE: Any page containing keyword or taxonomy links requires the inclusion of either the [win211search] shortcode or the search form html. This shortcode and search form html code display the forms required to set the user's specified city, zipcode, geocoordinates, and county region. When a user enters a location, any keyword or taxonomy links will be automatically updated with the selected location information. The shortcode or search form code are not required if you are simply linking to http://win211.org or https://www.resourcehouse.info/win211/Index
The above examples can be extended to include Feature Filters. Filters can be used to further narrow down a list of search results by filtered criteria. In the above examples for 'Dental Care' we could also add to the search parameters the requirement that the results list return services which also accept a particular form of payment, for example 'WA Apple Health (Medicaid)'. A feature is added to the url by including:
f={FEATURE_CATEGORY}%3d{FEATURE_CODE}
To select appropriate feature codes and obtain the needed parameters, perform the keyword or taxonomy search for your topic on the website. On the search results page a list of filters will be offered in the left sidebar which apply to the current search. Select a filter from the list. From the url bar on the resulting search page copy the url segment &f=[...] up to the following &. Paste this filter code into both the href and data-relativeurl sections of your link.
Below is an example of a search for Dental Care with the Feature WA Apple Health (Medicaid).
<a href="https://www.resourcehouse.info/win211/Search?q=Dental+Care&f=Payment+options%3dWA+Apple+Health+(Medicaid)" target="blank"
data-relativeurl="Dental+Care&f=Payment+options%3dWA+Apple+Health+(Medicaid)">
Dental Services which accept WA Apple Health</a>
And an example of a taxonomy based search link with the Feature WA Apple Health (Medicaid).
<a href="https://www.resourcehouse.info/win211/Search/Topics/LV-1600/Dental_Care&f=Payment+options%3dWA+Apple+Health+(Medicaid)"
target="_blank" data-relativeurl="LV-1600/Dental_Care&f=Payment+options%3dWA+Apple+Health+(Medicaid)">Dental Care which accepts WA Apple Health</a>
Multiple features can be combined if desired. To include additional features in a link append &f={FEATURE_CATEGORY}%3d{FEATURE_CODE} to the end of the link and data-relativeurl.
As of this writing these settings in Washington are as follows:
- Query Parser: Extended Dismax
- Phrase Slop: 1
- Multi-Term Match: 2
- Search Fields: Provider Name, AKA Names, Service Name, Location Name, Taxonomy Terms (topic), Taxonomy Terms (target), Address (city), Address (zip), Taxonomy Synonyms
- Not included are: Service Description, Location Description, Address (street), County, Service Keywords, Features
- Distance Boost: 20 (tiered)
- Distance Spread: 5
- Name Boost: 0
- Topic Boost: 1
- Term Proximity Boost: 1
- Term Proximity Distance: 2
- Auto Radius Threshold: 0
- Use Service Priority: Yes
- Updated code for PHP 7.1 Compatability
- Updated incontact email addresses on city lookup to populate contact form
- Added incontact email addresses to city lookup to populate contact form
- Updated to latest taxonomy released Jan 4th, 2018
- Updated to latest taxonomy released Oct 2nd, 2017
- Address potential security issue.
- Fixes issue with Topic links with included Features or Regions to have a question mark appended.
- Increase autosuggest of both cities and keywords to 10 entries.
- Updated to new taxonomy table as of 03-20-2017.
- Added Counties to autosuggest list. Data from US Census.
- Added YH Codes to suggestion list.
- Fixes issue with overlapping citites and zipcodes.
- Added level 2-6 taxonomy terms, broadening the availablility of terms to the user.
- Sets link and keyword searches to be displayed in ascending order rather than default tiered sort.
- Includes plugin update script for updating within WordPress
- Fixes release information
- Convert static links to dynamic php links using Wordpress plugin_url
- Edited shortcode to work with dynamic directory path
- Fixed citiespath in javascript to use dynamic url path
- Renamed demo_ files to 211search_
- Initial release
- Added url constructing code for taxonomy links.
- Added taxonomy documentation to readme files with examples
- Added documentation for creating links for both keyword and taxonomy searches
- Added documentation on adding features and needed link structures
- Updated README.txt and README.md
- Added jquery-ui styling from CDN
- Added region selector to keyword and url search
- Populated autocomplete keyword list from used taxonomy
- Updated code to reflect the new resourcehouse.info/win211 domain
- Removed Minnesota Locations from autocomplete
- Shortcode functionality added to plugin
- Build url code added and edited, plugin now functioning
- Repository initiated, Minnesotahelp.info code rolled in to plugin
- Create an issue describing a problem or discuss your idea
- Fork it
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Publish the branch (
git push origin my-new-feature) - Create a new Pull Request
- Profit!
See Contributors
Released under the GPLv2.
You can donate to this project and WIN211 by visiting http://win211.org/about/donate/