Skip to content

Latest commit

 

History

History
79 lines (58 loc) · 6.62 KB

CUSTOMIZE.md

File metadata and controls

79 lines (58 loc) · 6.62 KB
Raw

Customizing Ohana Web Search

Make sure you've installed the app first.

Environment variables

Inside the config folder, you will find a file named application.yml. Read through the documentation to learn how you can customize the app to suit your needs.

If you're planning on deploying the app to Heroku, you can set all the required environment variables in production by running the following command:

$ script/setup_heroku -a your_app_name -o your_api_endpoint

your_api_endpoint is the URL to your instance of Ohana API, such as http://ohana-api-demo.herokuapp.com/api. your_app_name is your Heroku app's name. Read the script for more details about what it will install.

The script only sets required environment variables. To set optional environment variables on Heroku, such as GOOGLE_ANALYTICS_ID, you'll need to set them manually. Read through application.example.yml to learn about all the optional variables you can set, and read the Heroku documentation to learn how to set Heroku configuration variables.

By default, the script assumes you will be using a *.herokuapp.com domain name. If you will be using a custom domain name, you will need to set the CANONICAL_URL and DOMAIN_NAME variables manually. Read application.example.yml for more details about those variables.

Website settings

Inside the config folder, you will find a file called settings.yml. In that file, there are many settings you can, and should, customize. Read through the documentation to learn how you can customize the app to suit your needs.

Localization

Inside the config/locales folder, you will find a file called en.yml. In that file, you can customize much of the user-facing text on the website. Most of the text should be ready to go, but there is one specific setting you should customize: the location value under branding.

Language Translation Services

The application uses Google Translate for free language translation of the site. The Google Website Translator Gadget appears in the footer of the site and provides free translation of the site into dozens of languages. By default, six major language translation links are provided (in their native script) on the upper-right of the homepage. A number of aspects related to translation can be customized:

  • Homepage language links. The language translation links on the homepage can be added, removed, and edited in config/settings.yml.

  • Support for saving custom translations. If you want to make edits to the Google provided translations of a live site you can add a GOOGLE_TRANSLATE_CUSTOMIZATION_CODE in config/application.yml. Follow the directions in that file for obtaining the proper code for your site.

  • Support for non-English keyword searches. If you want your users to be able to enter a keyword search in a language other than English, do the following:

    1. Uncomment the Google Translate related lines in app/controllers/locations_controller.rb.
    2. Add a GOOGLE_TRANSLATE_API_KEY in config/application.yml. Follow the directions in that file for obtaining an API key from Google. NOTE: GOOGLE CHARGES FOR THIS FEATURE.

  • Change the gadget layout. If you want to change the Google Website Translator Gadget's layout, two of the layouts provided by Google are supported: InlineLayout.VERTICAL and InlineLayout.HORIZONTAL. One or the other can be set in assets/javascripts/application.js.

Pagination

The pagination of search results is handled by the Kaminari gem. To configure the functionality, make changes in kaminari_config.rb. To change the informational text about the search results, visit the page_entries_info section in en.yml. To change the labels for the navigation buttons, visit the pagination section in en.yml. To change the markup, make changes to the partials in app/views/kaminari.

To test the pagination feature, you might find it handy to force a particular number of results per page by adding the per_page parameter to the end of the URL. For example: http://ohana-web-search-demo.herokuapp.com/locations?utf8=%E2%9C%93&keyword=&location=&per_page=5

Map marker graphics

The root graphics folder contains source files for images in the application. In this directory, you can find an Adobe Illustrator source file for the Google map marker graphics. With this file you can adjust the map marker appearance by making changes and exporting and overwriting the files in /app/assets/images/markers. The Google map appears on the search results and location details pages.

Adding JavaScript code

Ohana Web Search doesn't use the default application.js manifest file for loading JavaScript files that may be found in a typical Rails app. Instead, it uses a modular JavaScript pattern through the requirejs-rails gem. More information about this setup can be found in the modified application.js file and the RequireJS configuration file.

Allow search engines to index your site

Search engines are blocked by default so that they don't index your site until it's ready. Once your site is serving your own data from your own instance of Ohana API, and once you're satisfied with the content on your site, then you can invite search engines to index your site by commenting out lines 4 and 5 in public/robots.txt, like so:

# User-agent: *
# Disallow: /

Caching

See our Wiki article on improving performance with caching.