
### Version - Headless-1

***
■ ver 0.9.8 , 2021/02/23

* api, order (並び替え) 追加

https://cms-kuc-jamstack1.netlify.app/posts/6029d12e68013b004be190e5

***
■ ver 0.9.7 , 2021/02/19

* クロスドメイン対応

***
■ ver 0.9.6 , 2021/02/11

* api/find : start, limit指定の追加

https://cms-kuc-jamstack1.netlify.app/posts/6029d12e68013b004be190e5

***
■ ver 0.9.5 , 2021/02/09

* content 検索 add

* ログイン、メッセージ等修正

***
■ ver 0.9.4 , 2021/02/07

* webhoook add

https://cms-kuc-jamstack1.netlify.app/posts/6029d22668013b004be190e7

***
■ ver 0.9.2 , 2021/02/03

* API 書込、追加

https://cms-kuc-jamstack1.netlify.app/posts/6029d17768013b004be190e6

***
■ ver 0.9.1 , 2021/01/29

* new release

***


Version - Headless-1


### export Data

***

* CMSデータのエクスポート、インポート可能なshell になります
* 全てのサイトデータが、エクポート対象になります
 (指定サイト単位のエクスポートは出来ません)
* mongoexport 等で mongo collection 単位でエクスポートできます
* バックアップ、移行(他mongodb に引越し)ツール的な利用が可能です
* shell内の変数で、db名を指定しています。
  初期のdb名から変更している場合、修正が必要になります

***
### ■ shのフォルダ

https://github.com/kuc-arc-f/headless-1/tree/main/data/db

***
### ■ export

./export.sh

* linux実行する場合、実行権限が必要になります
* exportされた。jsonファイルが出力されます


***
### ■ import

./import.sh

* linux実行する場合、実行権限が必要になります
* exportされたjsonファイルを、import可能です

***


export Data - Headless-1


### Webhook - Headless-1

* ver 0.9.4 移行で利用可能です。
***

* netlifyの webhookを、起動できます。
* Site 単位で、webhook URL設定が必要となります。
* 手動実行でボタンを押す必要があります。コンテンツ保存時の、自動実行ではありません
* 実行後は、netlifyの deploy画面で。SSGコンパイル完了を確認頂く事をお勧めします。
* どちらかというと、中級者向けの機能としています。

***
### webhook URL　の設定

* Site setting (sites > Site Setting)
* webhook URLを、入力し。 Save で保存

![img](https://img-static-kuc.netlify.app/img/headless_doc/1_webhook_set.png)

***
### webhook 実行

* content画面 (site > open)　で、 [Webhook] ボタン押す

* webhook画面で、[webhook start]　ボタンを押す

* webhookか開始され、netlify　のdeploy画面等でコンパイル処理が確認できます。

***

　


Webhook - Headless-1


### API Write sample - Headless-1

* ver 0.9.2移行で利用可能です。

***
### create

create , content

* curl sample

```
curl  -X POST http://localhost:3001/api/post/create/test_1 -d "title=t203a" -d "content=c203a" -H "apikey:6017b16942e8e9010d663a66"
```
URL : /api/post/create/content_name

* content_name

Site > ContentType > content name

* apikey

Site > open > apikey

***
### delete

delete , content

* curl sample

```
curl  -X POST http://localhost:3001/api/post/delete/test_1 -d "id=601b42c70a2845528036132b" -H "apikey:1Nopktm1ZS34d1GDivZ47ocs"

```
URL : /api/post/delete/content_name

* content_name

Site > ContentType > content name

* id

content.id

* apikey

Site > open > apikey


***
### update

update , content

* curl sample

```
curl  -X POST http://localhost:3001/api/post/update/test_1 -d "id=601b7573c38b34435646fc6b" -d "title=t204c" -d "content=c204c" -H "apikey:1Nopktm1ZS34d1GDivZ47ocs"
```
URL : /api/post/update/content_name

* content_name

Site > ContentType > content name

* id

content.id

* apikey

Site > open > apikey



API Write sample - Headless-1


# API sample - Headless-1

***
### find

get, content List

* curl sample

```
curl "http://localhost:3001/api/get/find?content=books&site_id=6017b16942e8e9010d663a66"
```

* content

content name : Site > ContentType > content name

* site_id

site_id : Site > open > site_id

***
* skip, limit (option)

skip : start position

limit : limit record count

* curl sample / skip, limit

```
curl "http://localhost:3001/api/get/find?content=test_1&site_id=601a52687c693223ee03f570&skip=0&limit=10"
```

***
* order (option)　、並び替え

* colmun name : ex price

* ASC/DESC : 

  ＡSC : 昇順

  DESC : 降順

数値以外は、正しくソートできません

* curl sample  / order

```
curl "http://localhost:3001/api/get/find?content=test_6&site_id=601a52687c693223ee03f570&order=price:DESC"

```

***
### findone

get 1 record

* curl sample

```
curl "http://localhost:3001/api/get/findone?content=books&id=6018971bdaeb9700fed5345d"
```

* content

content name : Site > ContentType > content name

* id

 content_id

***
### count

リストの件数

* curl sample

```
curl "http://localhost:3001/api/get/count?content=books&site_id=6017b16942e8e9010d663a66"
```

* content

content name : Site > ContentType > content name

* site_id

site_id : Site > open > site_id

***



API sample - Headless-1


### 操作手順 - Headless-1

***
### Login

* Topを開き、Login リンク押す
* Login画面で、 Signup 押す
* ユーザー登録の。　mail, name , passwordを入力して保存
* Login画面で、mail, password を入力して ログイン

![img](https://img-static-kuc.netlify.app/img/headless_doc/1_login.png)

***
### Site作成

* site > create
* サイト名入力、保存　(説明は無しで可)

![img](https://img-static-kuc.netlify.app/img/headless_doc/1_site_add.png)

***
### ContentType作成(APIスキーマ)
* site > サイト選択 > ContentType
* Create ContentTYpe 押す
* Content Name ,各項目 入力、型の選択(Text, textArea)
* 下の、Create 押す 

![img](https://img-static-kuc.netlify.app/img/headless_doc/1_contype_add.png)

***
### Content作成(データの追加)
* サイト選択 > 左Contentリスト > 追加するContent　押す
* 右枠＞　Create Content 押す
* 各項目の、データ入力 > 下の Create 押す

![img](https://img-static-kuc.netlify.app/img/headless_doc/1_content_add1.png)

###




操作手順 - Headless-1


### 初期設定 - Headless-1

***
### Setup

npm install

***
### Setup , etc
* next.config.js , 

if change URL, mongodb URL, database name

```
BASE_URL: "http://localhost:3001"
MONGODB_URL: "mongodb://localhost:27017",
MONGODB_DB_NAME: "hcms",    
```

* package.json / scripts

if change, port number ( -p )

```
"dev": "next dev -p 3001"
```

***
### Start server
* Start :

```
yarn dev
```

* if change ,release mode

```
yarn serve
```

