This is a purely client-side application using JQuery, that will connect to any prismic.io repository, and trivially list its documents. It uses the prismic.io JavaScript development kit, and provides a few helpers to integrate with JQuery, as well as a basic templating engine.
The embedded templating engine is JavaScript Micro-templating (http://ejohn.org/blog/javascript-micro-templating/), but you can easily switch for any other JavaScript templating engine you may want.
This starter project uses the browser sessionStorage
to store the access token when you interactively login to preview the future releases of your repository. Therefore, to preview another release than Master, a modern browser supporting HTML5 is required.
Since it's all client-side, you don't need more than a web browser: simply open the index.html
file in your browser.
If you wish to simulate a client-server architecture anyway, you can also launch a local Web server using the server.sh
script and open the home page at http://localhost:8000/ (Python is required)
Your JQuery starter project is now working! However, by default, it will list and display documents from our "Les Bonnes Choses" example repository.
Edit the script/prismic-configuration.js
file to make the application point to the correct repository:
var Configuration = {
// -- API endpoint
apiEndpoint: 'https://lesbonneschoses.prismic.io/api'
// -- Access token if the Master is not open
// accessToken: 'xxxxxx',
// -- OAuth
// clientId: 'xxxxxx',
// clientSecret: 'xxxxxx'
}
To set up the OAuth configuration and interactive signin, go to the Applications panel in your repository's settings, and create a new OAuth application. You simply have to fill in an application name and potentially the callback URL (localhost
URLs are always authorized, so at development time you can omit to fill in the Callback URL field). After submitting, copy/paste the clientId
& clientSecret
tokens into the proper place in your configuration.
As this application is just made of static files, you can publish it to any web server. One simple way to do that is to use Github pages. Just push this Git repository on Github and create a gh-pages
branch to publish it to your own Github pages:
git checkout --orphan gh-pages
git commit -a -m "Push to Github pages"
git push origin gh-pages
You can then visit your website at:
http://your-github-user.github.io/your-github-repository.
You can find out how to get started with prismic.io on our prismic.io developer's portal.
You'll find more information about how to use the development kit included in this starter project, by reading its README file.
Contribution is open to all developer levels, read our "Contribute to the official kits" documentation to learn more.
This software is licensed under the Apache 2 license, quoted below.
Copyright 2013 Zengularity (http://www.zengularity.com).
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this project except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.