diff --git a/docs/3.x.x/en/assets/getting-started_add-entry.png b/docs/3.x.x/en/assets/getting-started_add-entry.png deleted file mode 100644 index 1acb868972..0000000000 Binary files a/docs/3.x.x/en/assets/getting-started_add-entry.png and /dev/null differ diff --git a/docs/3.x.x/en/assets/getting-started_add_entry.png b/docs/3.x.x/en/assets/getting-started_add_entry.png new file mode 100644 index 0000000000..3641893a2d Binary files /dev/null and b/docs/3.x.x/en/assets/getting-started_add_entry.png differ diff --git a/docs/3.x.x/en/assets/getting-started_allow_access.png b/docs/3.x.x/en/assets/getting-started_allow_access.png new file mode 100644 index 0000000000..3c87f056b0 Binary files /dev/null and b/docs/3.x.x/en/assets/getting-started_allow_access.png differ diff --git a/docs/3.x.x/en/assets/getting-started_create-content-type.png b/docs/3.x.x/en/assets/getting-started_create-content-type.png deleted file mode 100644 index 07f6b0a29d..0000000000 Binary files a/docs/3.x.x/en/assets/getting-started_create-content-type.png and /dev/null differ diff --git a/docs/3.x.x/en/assets/getting-started_create_content_type.png b/docs/3.x.x/en/assets/getting-started_create_content_type.png new file mode 100644 index 0000000000..01bcb17035 Binary files /dev/null and b/docs/3.x.x/en/assets/getting-started_create_content_type.png differ diff --git a/docs/3.x.x/en/assets/getting-started_list-fields.png b/docs/3.x.x/en/assets/getting-started_list-fields.png deleted file mode 100644 index 5ecb505465..0000000000 Binary files a/docs/3.x.x/en/assets/getting-started_list-fields.png and /dev/null differ diff --git a/docs/3.x.x/en/assets/getting-started_list_fields.png b/docs/3.x.x/en/assets/getting-started_list_fields.png new file mode 100644 index 0000000000..eda037d52e Binary files /dev/null and b/docs/3.x.x/en/assets/getting-started_list_fields.png differ diff --git a/docs/3.x.x/en/assets/getting-started_manage_role_home.png b/docs/3.x.x/en/assets/getting-started_manage_role_home.png new file mode 100644 index 0000000000..30844f5da0 Binary files /dev/null and b/docs/3.x.x/en/assets/getting-started_manage_role_home.png differ diff --git a/docs/3.x.x/en/assets/getting-started_no-content-type.png b/docs/3.x.x/en/assets/getting-started_no-content-type.png deleted file mode 100644 index 72c32fc6d0..0000000000 Binary files a/docs/3.x.x/en/assets/getting-started_no-content-type.png and /dev/null differ diff --git a/docs/3.x.x/en/assets/getting-started_no-entry.png b/docs/3.x.x/en/assets/getting-started_no-entry.png deleted file mode 100644 index 4132a78765..0000000000 Binary files a/docs/3.x.x/en/assets/getting-started_no-entry.png and /dev/null differ diff --git a/docs/3.x.x/en/assets/getting-started_no_content_type.png b/docs/3.x.x/en/assets/getting-started_no_content_type.png new file mode 100644 index 0000000000..4df862022e Binary files /dev/null and b/docs/3.x.x/en/assets/getting-started_no_content_type.png differ diff --git a/docs/3.x.x/en/assets/getting-started_no_entry.png b/docs/3.x.x/en/assets/getting-started_no_entry.png new file mode 100644 index 0000000000..dfaae83f68 Binary files /dev/null and b/docs/3.x.x/en/assets/getting-started_no_entry.png differ diff --git a/docs/3.x.x/en/assets/getting-started_register.png b/docs/3.x.x/en/assets/getting-started_register.png new file mode 100644 index 0000000000..8532758787 Binary files /dev/null and b/docs/3.x.x/en/assets/getting-started_register.png differ diff --git a/docs/3.x.x/en/assets/getting-started_with-entry.png b/docs/3.x.x/en/assets/getting-started_with-entry.png deleted file mode 100644 index 1ca9365de9..0000000000 Binary files a/docs/3.x.x/en/assets/getting-started_with-entry.png and /dev/null differ diff --git a/docs/3.x.x/en/assets/getting-started_with_entry.png b/docs/3.x.x/en/assets/getting-started_with_entry.png new file mode 100644 index 0000000000..0f51766cfa Binary files /dev/null and b/docs/3.x.x/en/assets/getting-started_with_entry.png differ diff --git a/docs/3.x.x/en/getting-started/quick-start.md b/docs/3.x.x/en/getting-started/quick-start.md index 87f3106d9b..2c7de51aba 100644 --- a/docs/3.x.x/en/getting-started/quick-start.md +++ b/docs/3.x.x/en/getting-started/quick-start.md @@ -1,6 +1,6 @@ # Quick start -This section explains how to handle Strapi for the first time. +This section explains how to handle Strapi for the first time, ([check out our tutorial video](https://www.youtube.com/watch?v=yMl5IcFHA74)). **Table of contents:** - [Create your first project](#create-your-first-project) @@ -50,10 +50,23 @@ strapi start ![Start Strapi](../assets/terminal_start.png) -Now that your app is running let's see how to [create your first api](#create-your-first-api). +Now that your app is running let's see how to [create your first user](#create-your-first-user). *** +## Create your first user + +In order to use the admin panel and to consume your API you first need to register your first user. This process only happens once if you don't have any user table created and is made to create the `admin user` that has all the permissions granted for your API. + +If your using MongoDB for your database you don't have to create your table manually (it's already handled by Strapi) otherwise you'll have to create your user table first. + +To create your first user, start your server (`strapi start`) and go to : http://localhost:1337/admin/plugins/users-permissions/auth/register. + +![Register View](../assets/getting-started_register.png) + + +Now that your first user is registered let's see how to [create your first api](#create-your-first-api). +*** ## Create your first API To create your first API, start your server (`strapi start`) and go to : http://localhost:1337/admin. @@ -62,11 +75,11 @@ At this point, your application is empty. To create your first API is to use the **#1 —** Go to the **Content Type Builder** plugin. -![Content Type Builder - Home](../assets/getting-started_no-content-type.png) +![Content Type Builder - Home](../assets/getting-started_no_content_type.png) **#2 —** Create a Content Type name `Product` and submit the form. -![Content Type Builder - Create a new Content Type](../assets/getting-started_create-content-type.png) +![Content Type Builder - Create a new Content Type](../assets/getting-started_create_content_type.png) **#3 —** Add three fields in this Content Type. @@ -74,7 +87,7 @@ At this point, your application is empty. To create your first API is to use the - A `text` field named `description`. - A `number` field named `price` (with `float` as number format). -![Content Type Builder - List fields in Product](../assets/getting-started_list-fields.png) +![Content Type Builder - List fields in Product](../assets/getting-started_list_fields.png) **#4 —** Save. That's it! @@ -96,21 +109,31 @@ After creating [your first Content Type](#create-your-first-api), it would be gr **#1 —** Go to the [**Product list**](http://localhost:1337/admin/plugins/content-manager/product/) by clicking on the link in the left menu (generated by the **Content Manager** plugin). -![Content Type Builder - Home](../assets/getting-started_no-entry.png) +![Content Type Builder - Home](../assets/getting-started_no_entry.png) **#2 —** Click on the button `Add New Product` and fill the form. -![Content Type Builder - Home](../assets/getting-started_add-entry.png) +![Content Type Builder - Home](../assets/getting-started_add_entry.png) **#3 —** Save! You can edit or delete this entry by clicking on the icons at the right of the row. -![Content Type Builder - Home](../assets/getting-started_with-entry.png) +![Content Type Builder - Home](../assets/getting-started_with_entry.png) *** ## Consume your API Your API is now ready and [contains data](#manage-your-data). At this point, you'll probably want to use this data in mobile or desktop applications. +In order to do so, you'll need to allow access to other users (identified as 'Guest'). + +**1 -** Go to the [** Auth & Permissions View**](http://localhost:1337/admin/plugins/users-permissions/roles) by clicking on **Auth & Permissions** link in the left menu and click on the **Guest Role** item. + +![Auth & Permissions - Home](../assets/getting-started_manage_role_home.png) + +**2 -** Manage your APIs permissions in the **Permissions** section of the [** Edit Guest Role view**](http://localhost:1337/admin/plugins/users-permissions/roles/edit/1) by enabling or disabling specific actions. + +![Auth & Permissions - Edit Guest](../assets/getting-started_allow_access.png) + ### List entries (GET)