404 Person Not Found
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
data/scrapers
dist
example
src
.gitignore
.jshintrc
LICENSE
README.md
bower.json
gulpfile.js
package.json

README.md

comebackhome

Add an unintrusive banner with photos of missing people to your site's 404 pages in the off-chance that someone who visits your site might recognize them.

Usage

Simply include the script into your HTTP 404 - Page Not Found page:

<script src="//comebackhome.org/js/comebackhome.bundle.min.js"></script>

You could also choose to include a local version of the script:

<script src="dist/comebackhome.bundle.min.js"></script>

How can I contribute?

Distribution is crucial for this plugin. The more people searching for missing people, the better the chances that someone will be found.

The most effective way to contribute to this effort is to include this plugin in your site, and the sites of your friends and employer.

You can also contribute by providing access to databases of missing people. We will be open-sourcing the API to push to our missing persons database soon, but until then, you can email contact@comebackhome.org with details.

Finally, you can also help by improving the plugin. In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality

Development

Tools

We use the following tools for development:

  • NodeJS required to run gulp.
  • gulp for task management and build process.
  • stylus for writing css

Getting started

  1. Install NodeJS

  2. Install gulp globally:

    $ npm install --global gulp
  3. Run gulp to build the source files. You will find the output under dist

    $ gulp

The plugin's code is contained in src/comebackhome.js and the styles are contained in src/comebackhome.styl. The templates of how the results are displayed are captured in the files in the src/templates directory.

Internationalization

The translatable source strings and their translations are hosted on Transifex.

To build an internationalized version of comebackhome, run the following command. The language version will be written to dist/<language_code>

$ gulp build --language zh_CN

License

Copyright (c) 2015 Bipin Suresh. Licensed under the GPL license.