Go to file
2018-04-16 10:15:28 +02:00
example_img Updated Libs, refactoring, cleaning up 2018-04-16 10:15:14 +02:00
hp_assets Updated Libs, refactoring, cleaning up 2018-04-16 10:15:14 +02:00
.gitignore Responsiveness, scrolling in link-wrapper 2017-02-20 14:57:52 +01:00
config.sample.json Updated Libs, refactoring, cleaning up 2018-04-16 10:15:14 +02:00
CONTRIBUTING.md Screenshots added, License changes 2017-02-20 16:18:42 +01:00
favicon.ico Responsiveness, scrolling in link-wrapper 2017-02-20 14:57:52 +01:00
index.php Updated Libs, refactoring, cleaning up 2018-04-16 10:15:14 +02:00
LICENSE.md Update LICENSE.md 2017-02-20 15:09:19 +01:00
README.md Merge branch 'master' of https://github.com/Swagielka/simple-homepage 2018-04-16 10:15:28 +02:00

simple-homepage

An even simpler, fully responsive Homepage. Ideal for Desktop and mobile usage! Based on: https://github.com/thetomester13/homepage

This project uses:

  • jQuery
  • Bootstrap CSS
  • Font Awesome
  • Unsplash
  • Trianglify

Screenshots

Homepage Desktop Trianglify Homepage Mobile Trianglify Homepage Desktop Unsplash Homepage Mobile Unsplash

To Use

Copy the config.sample.json file and rename to config.json. Be sure to update the fields as you see appropriate. You have the option to use the Unsplash API to fetch background images, or use a custom URL and JSON selector. If you choose to use Unsplash, will need to create a developer profile at Unsplash to use the background image functionality properly.

Configure Homepage

  • 'items' => The menu will scale to the amount of items you want to display. Insert any link you'd like, or {{cur}} for the current URL of the page. Choose icons from Font Awesome

Unsplash Background Images

  • 'unsplash_client_id' => Get Unsplash client ID from Unsplash. Leave this blank if you want to use Trianglify!
  • 'credits' => Whether you want to give credits to the artists, or not.

Custom Background Images

  • 'custom_url' => Input a custom URL that will return proper JSON
  • 'custom_url_headers' => Add any headers that may be needed to complete a cURL request to the aforementioned URL properly
  • 'custom_url_selector' => Input a proper PHP array selector to be used on the JSON received above. For example, if I were to fetch from Github's user API with a 'custom_url' of 'https://api.github.com/users/octocat', the 'custom_url_selector' would simply be "['avatar_url']". [{random}] can be replaced for a random index in an array.