Docs » Configuring your CMS

Webhook makes it easy to configure a custom Content Management System (CMS) to enter content into your site. Once your site is created, go to http://localhost:2002/cms/ to get started. You'll be presented with the following screen.

Start from a theme

The first choice you'll need to make when setting up your CMS is deciding whether you want to use a theme or not. Webhook themes effect not only the look and feel of your site, but also set up matching forms in the CMS itself. Although Webhook ships a few officially supported themes, most are made by our community. If you're interested in setting up your own themes, or using theme heavily please check out the themes guide. Once you've installed your theme you're pretty much good to go and can ignore the rest of this document unless you want to make additions or edits to the forms it sets up.

Start from scratch

If you're a designer comfortable with HTML, CSS and light template work you'll likely want to start from scratch. This gives you access to Webhook's powerful form builder which lets you set up custom CMS forms specific to your project.

Adding new forms to the CMS

Webhook stores all its form data into separate buckets we like to call content types. All content types come with a form that allows you to add content into that type. On the template side, you can call data from that content type at any time with some simple calls, but to start lets get the actual form in the CMS itself. To begin, click the Add / Edit Content Types section of the menu.

Lets say we want to add Video games to our new site. You'll want to start by saying that yes, there are multiple video games. This is important, because it lets Webhook know we need to create separate urls for each video game we enter into the system. If we'd answered that there was only one video game, we'd only be able to edit the data for one videogame, leaving it up to the template designer to place that data in the template as needed.

Once you've named your content type it's time to create the form for it. As seen below we've added some basic form fields that make up our Video Games. Name is a reserved, required field for all content types. It's what will form the URL structure for the output pages. The rest we added using the widgets available to us.

Automatic scaffolding and URL handling

Once we're done with our form, go ahead and hit save. As it saves, Webhook will do a few things.

  • You now have a video games menu item where you can add new video games to the site.
  • Webhook automatically creates some basic templates for you. So you should now have a /templates/videogames/ directory.
  • You can now view your videogames at http://localhost:2002/videogames/

Editing your templates

Now that you have your forms set up its time to edit your templates and apply your design. At this point you should check out the template and filter documentation for examples on pulling content from the CMS.