• Document Up to Date
  • Updated On 4.0.1

Your First Project

This section assumes that you have followed the steps in the Quick Start Guide to get CrafterCMS and login. We will be using an out-of-the-box blueprint, called “Website Editorial” to create your first project.

Let’s get started building your first project!

Creating your project from out of the box blueprint Website Editorial

After logging in, you’ll see the Projects screen (Below). Click on Create Project

Your First Project - Projects Screen

In the Create Project screen, the user is presented with the available blueprints or the option to use a remote Git repository instead of selecting a blueprint from the list. CrafterCMS provides default blueprints available out of the box from Crafter Studio and the Public Marketplace, which contains blueprints submitted to the Crafter Marketplace GitHub App to create a new project. To see all available blueprints, just scroll down the screen.

We’re going to be using the “Website Editorial Blueprint”. Blueprints offer you a starting point for your project. New blueprints can be created and installed into the system. Click on Use for the “Website Editorial Blueprint”.

Your First Project - Create Project: Choose a Blueprint

Give the project a friendly name for the Project Name and a description. Click on the Review button.

Your First Project - Create Project: Basic Information

The next step is to review your entries and finally create your new project. Click on the Create Project button and wait for the system to create your project based on the blueprint.

Your First Project - Create Project: Review and Create

A spinner will appear while it’s creating the following: configuration, project content, and permissions based on the template provided by the blueprint.

Your First Project - Creating a Project Spinner Dialog

When it’s done you will be taken to the Home Page of your project:

Your First Project - Home Page

Your project is setup, we can now start adding/editing content! To edit content you see on the page, click on the three dots next to the page url at the toolbar at the top, then select Edit. This will open a form (see below) where you can edit the page content. To see other ways of editing page content, see Editing a Page.

Your First Project - Editing Content

Adding a new article page to the project

We’ll be adding a new article to the project. To add a new article (or a new page), navigate to the level and location within the path navigator in the Sidebar where we want to create the new page. In this case, we are adding an article under articles -> 2021 -> 3. Click on the three dots next to the folder, then select New Content

Your First Project - New Content

We’ll then select the page template we want. Since we are adding a new article to the project, we will be selecting the template Article

Your First Project - Select Page Template

We’ll start filling out the form for our new article, “Where to find cherry blossoms in Virginia”. For the Page URL, replace spaces with dashes. You can write the Internal Name and Title however you like as long as it is 50 characters or less as indicated on the right of the input boxes. For the Header and Left Rail, we will be using the default provided by the template.

Your First Project - Page Properties

The next section on the form is the Metadata section, where we can select the category for our article, the targeted segments of the article and whether our new article should be added to the Featured section. Our new article, will be under Entertainment for the Categories and the targeted segments is Gal. We will also be placing our new article in the Featured section.

Your First Project - Page Metadata Section

Finally, we add our blurb in the Content section of the form. Here, we fill out the Subject, Author, Date, Summary, Image and Section, which contains the content of our article.

Your First Project - Page Content Section

Here’s the project, with our newly created article in the featured section.

Your First Project - Newly Created Project Home Page

You can add more pages or modify/remove the existing pages from the blueprint, depending on your needs. To remove or edit an existing page, navigate to the location of the article you want to edit/remove. Right click on it, then select the action you would like to do on the page.

Your First Project - Edit a Page

Updating the Contact Us section in the sidebar

Another thing that we may want to modify from the blueprint, is the left rail. For this example, we are going to modify the Contact Us section in the left rail (contact widget).

There are a few ways to edit the Contact Us section. We can edit the section by opening the left rail components, say the Left Rail with Latest Articles. A form with all the editable content of the left rail will appear. Go to the Widgets section of the form, select Contact Widget and then click on the Edit button on the right of the list of widgets.

We can also edit the Contact Us section itself by editing the Contact Widget component. To edit the Contact Us section in the left rail, open the Sidebar then navigate to components -> contact. Click on the three dots next to Contact Widget then select Edit.

Your First Project - Edit the Contact Us section in the Left Rail

Let’s edit the “Left Rail with Latest Articles” by clicking on Options (three dots) next to it, then selecting Edit. A form with all the editable content of the left rail will appear. Go to the Widgets section of the form, select Contact Widget and then click on the Edit button on the right of the list of widgets.

Your First Project - Left Rail Form

A form containing all the editable fields in the Contact Us section will appear. Modify the fields that you want to change.

Your First Project - Contact Widget

Here’s the Sidebar with the Contact Us section updated. Notice that you can also modify the text in the Contact Us section directly by turning on Edit Mode by clicking on the pencil icon at the top right of your screen which enables in-context editing, and hovering the mouse over the area you wanted to edit, then clicking on it.

Your First Project - Updated Contact Us Section

Editing the features section, “Erat lacinia”

We will now edit the features section in our blueprint. The features in this section has been configured as components, as you will see in the images below. There are multiple ways of editing the features section in the blueprint.

Your First Project - Add Features through Drag and Drop

We’ll start out by adding a feature using the pencil that appears when you hover your mouse over the middle of the features section as shown in the image above. Click on the section then select Edit. A form will open containing the content of the section. As you can see in the image below, there are currently four features in the section.

Your First Project - Edit by Clicking on the Pencil

In this form, you can add another feature, by clicking on Add +, which will give you a menu to Create new embedded Feature (Uses an embedded data source available only on the current page/component) or Create new shared Feature (Uses a shared data source available to other pages/components)

We will add a feature by selecting Create new embedded Feature after you click on Add +. This will open a form, where we will now enter our content.

Your First Project - New Feature

Your First Project - New Feature Added

We will now add another feature, by using the Browse Components tool in the Experience Builder panel located on the right that is available when Edit Mode is on. This will bring up a list of existing shared features in the blueprint. Select one, then drag it to the drop target area on the page. This will add your selected existing feature to the features section of the page.

Your First Project - Browse for Existing Features Component

We will again add another feature, this time by using the Add Components tool in the Experience Builder panel located on the right. Click on the Add Components tool and it will list all components that you can drag and drop onto drop targets on the page. To click and drag a new feature onto the feature’s drop target, click and drag Feature from the Page Builder panel on to the feature drop target area on the page. This will then add a new feature component on the page containing some default items that you can then modify.

Your First Project - Drag and Drop Zone

From inside the drop zone, you may also re-arrange the features by clicking and dragging on a feature and placing it in your desired position.

Your First Project - Drag and Drop

To delete/remove a feature from the drop zone, just click on the feature then click on the trash bin that appears on the top of the feature when Edit mode or Move mode is enabled.

Your First Project - Drag and Drop Delete

Another way o delete/remove a feature from the drop zone is to just drag the feature to the trash bin that appears on the bottom right of the screen when dragging around a component.

Your First Project - Drag and Drop Delete

To edit a feature, mouse over the feature you want to edit, click on it then click on the pencil icon. This will open the content form. Edit the fields you would like to modify, then click on Save & Close or Save & Minimize to save your changes or click on Cancel to discard all changes in the form.

Your First Project - Edit Feature

Another way to remove a feature, is to edit the features section, then select a feature from the list and click on the trash can icon on the right.

Your First Project - Remove Feature

Publishing Your New/Edited Page

Your project is not yet published after creating the project from the Website Editorial blueprint. Once your project is published, if you make edits to any of the pages or created new pages, it will need to be published for your project visitors to see the changes. There are a couple of ways to publish your content edits. The first thing you need to do is to navigate to the item you want to publish in the Sidebar toggled on/off by clicking on the CrafterCMS logo with the hamburger icon on the upper left hand corner of Studio. After navigating to the item you want to publish, there are two ways to publish:

  • Click on the item you want to publish. In the toolbar at the top, click on the three dots next to the page address url, then select Publish
  • Click on the three dots next to the page you want to publish from the Sidebar, then click on Publish
Your First Project - Publish Your New Content

You will then be prompted whether you want to publish the page now (Now), or publish the page at a later date and time (Later). If this is the very first publish request, the user will be notified that the entire project will be published like below:

Your First Project - Publish Options

For more information on content authoring, please see the documentation section: Content Authoring