Skip to main content

List of extension items available in the content structure

The content structure includes the following three field items by default.

  • ContentID/Slug
  • Date
  • Title

Image from Gyazo

Field items can be added in the Content structure editor.

Reference: Content structure

Image from Gyazo

When you click on [Edit], it opens the item settings for additional field, allowing you to configure item types, input restrictions, and more.

Image from Gyazo

The available settings vary depending on the item, so please refer to the following.

List of Items

ContentID/Slug
Date/Sort
Category
Title
Content
Single-line text
Single-line text (autocomplete)
Multi-line text
WYSIWYG
HTML
Single choice
Multiple choice
Date picker
Master selection
Master (checkbox)
Relational data selection
Bool
Image (upload to KurocoFiles)
File (upload to KurocoFiles)
File (upload to GCS)
File (upload to S3)
File (from File manager)
Video (Vimeo)
API field
Counter
Link
Number
Table
Location

tip

Depending on the timing of your Kuroco application, the response for each item may be ext_X instead of ext_col_XX.
If it doesn't work, please check the response in the Swagger UI.

Default Items

ContentID/Slug

Display in Content Editing Screen

Image from Gyazo

Field settings - General

Image from Gyazo

ItemDescription
Field nameDisplays Content ID/Slug. Cannot be edited.
SlugDisplays topics_id/slug. Cannot be edited.
Auto generateWhen enabled, automatically generates a Slug if it is blank when adding content.
AnnotationEnter an annotation.

Field settings - Input restriction

Image from Gyazo

ItemDescription
RequiredWhen enabled, becomes a required input.
Input restrictionLimits the input string.
Regular expressionIf [Regular Expression] is selected in Input Restriction, enter a regular expression.
Character limitSet the minimum and maximum number of characters.

Field settings - Custom template

Image from Gyazo

ItemDescription
Template editorUsed when you want to change the display of the content editing screen.

JSON Response

details: {
"topics_id": id,
"slug": "slug",
},

Date/Sort

Display of the Content Editing Screen

When Use Date is selected. Image from Gyazo

When Use Sort is selected. Image from Gyazo

Field settings - General

When Use Date is selected. Image from Gyazo

When Use Sort is selected. Image from Gyazo

ItemDescription
Field nameDisplays DateorSort. Cannot be edited.
SlugDisplays ymd or order_no. Cannot be edited.
Field settingsSelect 'Use Date' or 'Use Sort'.
Also include time (hh:mm)When enabled, allows setting of time.
Available when Use Date is selected in the Field settings.
Also include seconds (hh:mm:ss)When enabled, allows setting of time and seconds.
Available when Use Date is selected in the Field settings.
AnnotationEnter a annotation.

Category

Display of the Content Editing Screen

Image from Gyazo

info

Displayed only when multiple categories are registered.

Field settings - General

Image from Gyazo

ItemDescription
Field nameDisplays Category. Cannot be edited.
SlugDisplays contents_type. Cannot be edited.
AnnotationEnter a annotation.

JSON Response

details: {
"ymd": "2024-01-11",
"order_no": 10,
},

Title

Display of the Content Editing Screen

Image from Gyazo

Field settings - General

Image from Gyazo

ItemDescription
Field nameDisplays Title. Cannot be edited.
SlugDisplays subject. Cannot be edited.
AnnotationEnter a annotation.

Field settings - Input restriction

Image from Gyazo

ItemDescription
Input restrictionLimits the input string.
Regular expressionIf Regular Expression is selected in the input restrictions, enter a regular expression.
Character limitSets the minimum and maximum character limits.

Field settings - Search setting

Image from Gyazo

ItemDescription
IndexingWhen enabled, an index is added to the database, and search results are responded quickly.

Field settings - Custom template

Image from Gyazo

ItemDescription
Template editorUsed when you want to change the display of the content editing screen.

JSON Response

details: {
"subject": "title",
},

Content

Display of the Content Editing Screen

Image from Gyazo

Field settings - General

Image from Gyazo

ItemDescription
Field nameDisplays content. Cannot be edited.
SlugDisplays contents. Cannot be edited.
Input Method for BodySelect the input method for the body from "WYSIWYG", "Text Area", or "Not Used".

Field settings - Custom template

Image from Gyazo

ItemDescription
wysiwyg_optionsThis is used when specifying additional CSS or color codes.

JSON Response

details: {
"contents": "text",
},

Single-line text

Display of Content Editing Screen

Image from Gyazo

Field settings - General

Image from Gyazo

ItemDescription
Field nameEnter the display name of the content editing screen.
SlugEnter the slug.
PlaceholderEnter the placeholder.
Default valuesEnter the default value.
AnnotationEnter the Annotation.

Item Settings - Input Restriction

Image from Gyazo Image from Gyazo

ItemDescription
Required settingWhen enabled, it becomes a required input.
Input restrictionYou can restrict the input string.
Character limitSet the minimum and maximum number of characters.
Regular expressionIf you select [Regular Expression] in the input restriction, enter the regular expression.

Field settings - Search setting

Image from Gyazo

ItemDescription
IndexingWhen enabled, an index is added to the database, and search results are responded quickly.

Field settings - Custom template

Image from Gyazo

ItemDescription
Template editorUsed when you want to change the display of the content editing screen.

JSON Response

details: {
"ext_X": "text",
},

Single-line text (autocomplete)

Display of Content Editing Screen

Image from Gyazo

Field settings - General

Image from Gyazo

ItemDescription
Field nameEnter the display name of the content editing screen.
SlugEnter the slug.
Content structure IDSet the content structure group ID to display in autocomplete.
FieldSet the extension number to display in autocomplete.
Example: subject,ext->>'1',ext_1
PlaceholderEnter the placeholder.
Default valuesEnter the default value.
AnnotationEnter the Annotation.

Item Settings - Input Restriction

Image from Gyazo

ItemDescription
Required settingWhen enabled, it becomes a required input.

Field settings - Search setting

Image from Gyazo

ItemDescription
IndexingWhen enabled, an index is added to the database, and search results are responded quickly.

Field settings - Custom template

Image from Gyazo

ItemDescription
Template editorUsed when you want to change the display of the content editing screen.

JSON Response

details: {
"ext_X":"Test Blog",
},

Multi-line text

Display of the Content Editing Screen

Image from Gyazo

Field settings - General

Image from Gyazo

ItemDescription
Field nameEnter the display name of the content editing screen.
SlugEnter the slug.
PlaceholderEnter the placeholder.
Default valuesEnter the default value.
AnnotationEnter the Annotation.

Field settings - Input restriction

Image from Gyazo

ItemDescription
Required settingWhen enabled, it becomes a required input.
Character limitSet the minimum and maximum number of characters.

Field settings - Search settings

Image from Gyazo

ItemDescription
IndexingWhen enabled, an index is added to the database, and search results are responded quickly.

Field settings - Custom template

Image from Gyazo

ItemDescription
Input field sizeSet the width and height of the text area to be displayed.
Example: 200
It will be specified in pixels (px).
It is also possible to set it by specifying the unit. Example: 200px, 50%
Template editorUsed when you want to change the display of the content editing screen.

JSON Response

details: {
"ext_X": "Text Area",
},

WYSIWYG

Display of the Content Editing Screen

Image from Gyazo

Field settings - General

Image from Gyazo

Image from Gyazo

ItemDescription
Field nameEnter the display name of the content editing screen.
SlugEnter the slug.
ResourceEnter the path to specify the directory path to display when ckfinder is launched.
Example: /files/user/test
Automatically convert to iframely code during API outputEnabling this will automatically convert the <oembed> tags used in the editor to Iframely and convert them to iframe code.
Grant tokens automaticallyWhen enabled, API requests sent with dynamic access token security will automatically have the authentication parameter t=... added to the URLs of files stored in KurocoFiles(Restricted)(/files/ltd/).
Please set this up when using files from the ltd folder within Wysiwyg with a dynamic access token.
WYSIWYG placeholderEnter the string to be used as a placeholder, separated by commas. Create and use custom processing to convert the placeholder to any string.
Default valuesEnter the default value.
AnnotationEnter a annotation.

Field settings - Input restriction

Image from Gyazo

ItemDescription
Required settingEnabling this will make it a required input.

Field settings - Search settings

Image from Gyazo

ItemDescription
IndexingEnabling this will add an index to the database, resulting in faster response times for search results.

Field settings - Custom template

Image from Gyazo

Image from Gyazo

ItemDescription
Input field sizeSpecify the width and height of the field.
Example: 200px, 50%
If no unit is specified, it will work as pixels (px).
Simple toolbarEnabling this will display a simplified toolbar.
Large color paletteEnabling this allows setting more than 16 color codes.
Use font size pxEnabling this will specify the font size in pixels.
Insert paragraph buttonEnabling this will display paragraph insertion buttons before and after block elements (div/section/article).
Please enable this option if you want to insert line breaks or WYSIWYG templates outside of block elements.
Delete pluginEnter the unnecessary plugins.
For detailed instructions, refer to How to Use WYSIWYG Editor.
Custom colorsSet the color codes to be included in the color palette.
For detailed instructions, refer to How to Set WYSIWYG Custom Colors.
Custom CSSSet the URL of the CSS to load the specified CSS in the editor.
Use markdownEnabling this will change the input format in source mode to Markdown.
Output formatSelect the output format for the response from the API when Use markdown is enabled.
WYSIWYG OptionsThis is used when utilizing additional WYSIWYG options.
The currently enabled options are as follows.
  • subscript::1:Adds superscript and subscript icons.
Template editorUsed when you want to change the display of the content editing screen.

JSON Response

"details": {
"ext_X": "<p><strong>Wysiwyg</strong> Text Area</p>",
},
info

In a WYSIWYG editor, automatic corrections may occur for HTML tags, such as removal of empty tags, removal of script tags, and completion of unknown tags. If you want to strictly control the HTML, please use the HTML field.

HTML

Display of the Content Editing Screen

Image from Gyazo

Field settings - General

Image from Gyazo

ItemDescription
Field nameEnter the display name of the content editing screen.
SlugEnter the slug.
Default valuesEnter the default value for the item.
*Even if "Allow all tags" is enabled, the use of <script> tags is not allowed in the default value.
AnnotationEnter a annotation.

Field settings - Input restriction

Image from Gyazo

ItemDescription
Required settingWhen enabled, it becomes a required input.
Allow all tagsWhen enabled, all tags can be used.
See below for tags available with disabled.
List of tags available by default
<blockquote>,<ruby>,<sup>,<sub>,<em>,<code>,<a>,<u>,<s>,<base>,<address>,<label>,<link> <center>,
<font>,<hr>,<ul>,<ol>,<li>,<strong>,<br>,<p>,<frame>,<noframes>,<b>,<i>,<rt>,<rb> <big>,<small>,
<img>,<b>,<photo>,<table>,<tr>,<td>,<th>,<thead>,<tbody>,<span>,<noembed>,<oembed>,<q> <style>,
<h1>,<h2>,<h3>,<h4>,<h5>,<h6>,<div>,<object>,<param>,<marquee>,<pre> <embed>,<map>,<area>,<dl>,
<dt>,<dd>,<iframe>,<input>,<select>,<option>,<textarea>,<noscript>,<form>,<>,<br/>,<hr/>,<abbr>,
<dfn>,<cite>,<button>,<ins>,<del> <caption>,<col>,<colgroup>,<tfoot>,<optgroup> <fb:activity>,
<fb:add-profile-tab>,<fb:bookmark>,<fb:comments>,<fb:friendpile>,<fb:like>,<fb:like-box>,
<fb:live-stream>,<fb:login-button>,<fb:pronoun>,<fb:recommendations>,<fb:serverFbml>,<fb:profile-pic>,
<fb:user-status>,<fb:comments-count> <g:plusone>,<gcse:search>,<gcse:searchresults-only>,
<gcse:searchbox-only>,<video>,<header>,<footer>,<nav>,<section>,<article> <aside>,<audio>,
<datalist>,<details>,<figcaption>,<figure>,<hgroup>,<keygen>,<mark>,<meter>,<output>,<progress>,
<rp>,<rt>,<source>,<picture>,<summary>,<time>,<wbr>,<main>

Field settings - Custom template

Image from Gyazo

ItemDescription
Input field sizeSpecify the width and height of the field.
Example: 200
It will be specified in pixels (px).
It is also possible to set it by specifying the unit. Example: 200px, 50%
Enable simple text editorWhen enabled, the input for HTML becomes a simple text area.
Template editorUsed when you want to change the display of the content editing screen.

JSON Response

details: {
"ext_X": "<div>\r\nhtml <p>text area</p>\r\n</div>",
},

Single choice

Display of the Content Editing Screen

Image from Gyazo

Field settings - General

Image from Gyazo

ItemDescription
Field nameEnter the display name of the content editing screen.
SlugEnter the slug.
Selection OptionsSet the key and value of the selection options.
AnnotationEnter a annotation.

Field settings - Input restriction

Image from Gyazo

ItemDescription
Required settingWhen enabled, it becomes a required input.

Field settings - Search settings

Image from Gyazo

ItemDescription
IndexingWhen enabled, an index is created in the database, and search results are responded quickly.

Field settings - Custom template

Image from Gyazo

ItemDescription
Use radio buttonsWhen enabled, the display of the content editing screen becomes radio buttons.
SeparatorEnter a string to separate each radio button.
Template editorUsed when you want to change the display of the content editing screen.

Multiple choice

Display of the Content Editing Screen

Image from Gyazo

Field settings - General

Image from Gyazo

ItemDescription
Field nameEnter the display name of the content editing screen.
SlugEnter the slug.
Selection OptionsSet the key and value of the selection options.
AnnotationEnter a annotation.

Field settings - Input restriction

Image from Gyazo

ItemDescription
Required settingEnabling this makes it a required input.

Field settings - Search settings

Image from Gyazo

ItemDescription
IndexingEnabling this adds an index to the database, resulting in faster search results and responses.

Field settings - Custom template

Image from Gyazo

ItemDescription
Use multiselectWhen enabled, use multi-select instead of checkboxes.
Please Enable this when there are many options. If the number of options exceeds 50, multi-select will be used automatically.
SeparatorEnter a string to separate each radio button.
Template editorUsed when you want to change the display of the content editing screen.

JSON Response

details: {
"ext_X": [
{
"key": "1",
"label": "Multiple Choice_Option 1"
},
{
"key": "2",
"label": "Multiple Choice_Option 2"
}
],
},

Date picker

Display on Content Editing Screen

Image from Gyazo

Field settings - General

Image from Gyazo

ItemDescription
Field nameEnter the display name on the content editing screen.
SlugEnter the slug.
PlaceholderEnter the placeholder.
Default valuesEnter the default value.
Relative dates can be specified using the specified format that can be used with the PHP strtotime function. Ex.) today / -12 hours
Also include time (hh:mm)Enabling this allows setting the time.
AnnotationEnter a annotation.

Field settings - Input restriction

Image from Gyazo

ItemDescription
Required settingEnabling this makes it a required input.

Field settings - Search settings

Image from Gyazo

ItemDescription
IndexingEnabling this adds an index to the database, resulting in faster search results and responses.

Field settings - Custom template

Image from Gyazo

ItemDescription
Template editorUsed when you want to change the display of the content editing screen.

JSON Response

details: {
"ext_X":"2021-06-04",
},

Master selection

Display on Content Editing Screen

Image from Gyazo

Field settings - General

Image from Gyazo

ItemDescription
Field nameEnter the display name on the content editing screen.
SlugEnter the slug.
Options:MasterSpecify the ID of the master to be used.
Options:KeySpecify the column number to be used as the key.
Options:ValueSpecify the column number to be used as the value.
Default valuesSpecify the value that should be pre-selected on initial transition.
Parent IDSpecify the parent ID.
AnnotationEnter a annotation.

Field settings - Input restriction

Image from Gyazo

ItemDescription
Required settingEnabling this makes it a required input.

Field settings - Search settings

Image from Gyazo

ItemDescription
IndexingWhen enabled, an index is created in the database, resulting in faster search results and responses.

Field settings - Custom template

Image from Gyazo

ItemDescription
Template editorUsed when you want to change the display of the content editing screen.

JSON Response

details: {
"ext_X": {
"key": "key",
"label": "0"
},
},

Master (checkbox)

Display on Content Editing Screen

Image from Gyazo

Field settings - General

Image from Gyazo

ItemDescription
Field nameEnter the display name on the content editing screen.
SlugEnter the slug.
Options:MasterSpecify the ID of the master to be used.
Options:KeySpecify the column number to be used as the key.
Options:ValueSpecify the column number to be used as the value.
Default valuesPlease specify the keys you want to be selected during the initial transition, separated by commas.
AnnotationEnter a annotation.

Field settings - Input restriction

Image from Gyazo

ItemDescription
Required settingEnabling this makes it a required input.

Field settings - Search settings

Image from Gyazo

ItemDescription
IndexingWhen enabled, an index is created in the database, resulting in faster search results and responses.

Field settings - Custom template

Image from Gyazo

ItemDescription
Template editorUsed when you want to change the display of the content editing screen.

JSON Response

details: {
"ext_X": [
{
"key": "key1",
"label": "label1"
},
{
"key": "key2",
"label": "label2"
}
],
},

Relational data selection

Display of Content Editing Screen

Image from Gyazo

Field settings - General

Image from Gyazo

Image from Gyazo

ItemDescription
Field nameEnter the display name of the content editing screen.
SlugEnter the Slug.
ModuleSpecify the function to be selected as related information.
Content structure IDSpecify the ID of the content structure to be selected as related information if the module is set to content.
Category IDIn the case of the module is set to content
Specify the ID of the category to be selected as related information if the module is set to content.
Filter by Permission SettingsIn the case of the module is set to content or member
Retrieve related information that can be executed by users who are logged in by specifying insert, update, delete.
Only MineIn the case of the module is set to content
Only related information created by users who are logged in will be retrieved.
Disable SecurityIn the case of the module is set to content
Disables access restrictions and allows retrieval of related information.
Sort OrderSet the sort order.
Specify it as topics_id=ASC. If you want to specify multiple combinations, you can specify it as subject=ASC,topics_id=ASC.
AnnotationEnter an annotation.

Field settings - Input restriction

Image from Gyazo

ItemDescription
Required settingWhen enabled, it becomes a required input.

Field settings - Search settings

Image from Gyazo

ItemDescription
IndexingWhen enabled, an index is created in the database, resulting in faster search results and responses.

Field settings - Custom template

Image from Gyazo

ItemDescription
Template editorUsed when you want to change the display of the content editing screen.

JSON Response

details: {
"ext_X": {
"module_type": "topics",
"module_id": 959
},
},

Bool

Display of Content Editing Screen

Image from Gyazo

Field settings - General

Image from Gyazo

ItemDescription
Field nameEnter the display name of the content editing screen.
SlugEnter the Slug.
Default valuesSelect the default value to be set as true/false.
AnnotationEnter an annotation.

Field settings - Input restriction

Image from Gyazo

ItemDescription
Required settingWhen enabled, it becomes a required input.

Field settings - Search settings

Image from Gyazo

ItemDescription
IndexingWhen enabled, an index is applied to the database, resulting in faster search results and responses.

Field settings - Custom template

None

JSON Response

details: {
"ext_X": false
},

Image (upload to KurocoFiles)

Display of the Content Editing Screen

Image from Gyazo

Field settings - General

Image from Gyazo

ItemDescription
Field nameEnter the display name of the content editing screen.
SlugEnter the slug.
AnnotationEnter a annotation.

Field settings - Input restriction

Image from Gyazo

ItemDescription
Required settingWhen enabled, it becomes a required input.
Allowed file extensionSpecify the file extensions allowed for upload.
Example: png, jpg
Note: If you specify jpg, files with the same MIME type, such as jpeg, jpe, jif, and jfif, can also be selected in the file selection dialog. However, the upload will be restricted to the specified file extensions only.

If not specified, the following extensions are allowed: jpg, jpeg, gif, png, svg,webp.
Maximum upload file size (MB)Limits the size of the uploaded image.

Field settings - Custom template

Image from Gyazo

ItemDescription
Hide captionWhen enabled, hides the input field for image description in the content editing screen.
Template editorUsed when you want to change the display of the content editing screen.

JSON Response

details: {
"ext_X": {
"id": "sample_0",
"url": "https://sample.g.kuroco-img.app/v=1623673449/files/topics/sample.png",
"desc": "",
"url_org": "https://hasebetest.g.kuroco-img.app/files/topics/sample.png"
},
},

File (upload to KurocoFiles)

Display of the Content Editing Screen

Image from Gyazo

Field settings - General

Image from Gyazo

ItemDescription
Field nameEnter the display name of the content editing screen.
SlugEnter the slug.
AnnotationEnter a annotation.

Field settings - Input restriction

Image from Gyazo

ItemDescription
Required settingWhen enabled, it becomes a required input.
Allowed file extensionsSpecify the file extensions allowed for upload.
Example: png, jpg
Note: If you specify jpg, files with the same MIME type, such as jpeg, jpe, jif, and jfif, can also be selected in the file selection dialog. However, the upload will be restricted to the specified file extensions only.

If not specified, all extensions are allowed.
Reference: What file formats does the file manager support?
Maximum upload file size (MB)Limits the size of the uploaded file.

Field settings - Custom template

Image from Gyazo

ItemDescription
Hide the input fieldWhen enabled, hides the input field for file name in the content editing screen.
Template editorUsed when you want to change the display of the content editing screen.

JSON Response

details: {
"ext_X": {
"id": "sample_0",
"url": "https://sample.g.kuroco-img.app/v=1623673449/files/topics/sample_0.pdf",
"url_org": "https://sample.g.kuroco-img.app/files/topics/sample_0.pdf",
"dl_link": "https://sample.g.kuroco.app/direct/topics/topics_file_download/?topics_id=960&ext_no=09&index=0",
"desc": "test"
},
},

File (upload to GCS)

File (upload to GCS) is available after integration with Firebase. Please refer to the following document for details on how to work with Firebase. Cloud storage integration with Firebase

Display of Content Editing Screen

Image from Gyazo

Field settings - General

Image from Gyazo

ItemDescription
Field nameEnter the display name of the content editing screen.
SlugEnter the slug.
InlineWhen enabled, the content will be displayed in the browser when clicked from the admin screen. The API response remains the same.
AnnotationEnter a annotation.

Field settings - Input restriction

Image from Gyazo

ItemDescription
Required settingWhen enabled, it becomes a required input.
Allowed file extensionsSpecify the file extensions allowed for upload.
Example: png, jpg
Note: If you specify jpg, files with the same MIME type, such as jpeg, jpe, jif, and jfif, can also be selected in the file selection dialog. However, the upload will be restricted to the specified file extensions only.

If not specified, all extensions are allowed.
Reference: What file formats does the file manager support?

Field settings - Custom template

Image from Gyazo

ItemDescription
Hide the input fieldWhen enabled, the input field for the file name will be hidden on the content editing screen.
Template editorUsed when you want to change the display of the content editing screen.

JSON Response

details: {
"ext_X": {
"id": "sample_0",
"url": "https://storage.googleapis.com/kuroco-test.appspot.com/files/topics/sample.png?X-Goog-Algorithm=xxxxx",
"desc": ""
},
},

File (upload to S3)

File (upload to S3) is available after integration with Amazon S3. Please refer to the following document for details on how to work with Amazon S3. Integrating and storing files with Amazon S3

Display of Content Editing Screen

Image from Gyazo

Field settings - General

Image from Gyazo

ItemDescription
Field nameEnter the display name of the content editing screen.
SlugEnter the slug.
InlineWhen enabled, the content will be displayed in the browser when clicked from the admin screen. The API response will not change.
AnnotationEnter an annotation.

Field settings - Input restriction

Image from Gyazo

ItemDescription
Required settingWhen enabled, it becomes a required input.
Allowed file extensionsSpecify the file extensions allowed for upload.
Example: png, jpg
Note: If you specify jpg, files with the same MIME type, such as jpeg, jpe, jif, and jfif, can also be selected in the file selection dialog. However, the upload will be restricted to the specified file extensions only.

If not specified, all extensions are allowed.
Reference: What file formats does the file manager support?

Field settings - Custom template

Image from Gyazo

ItemDescription
Hide the input fieldWhen enabled, the input field for the file name will be hidden on the content editing screen.
Template editorUsed when you want to change the display of the content editing screen.

JSON Response

details: {
"ext_X": {
"id": "sample_0",
"url": "https://kuroco-sample.s3.ap-northeast-1.amazonaws.com/files/topics/sample_0.jpeg?response-content-disposition=xxxxx",
"desc": ""
},
},

File (from File manager)

Display of the Content Editing Screen

Image from Gyazo

Field settings - General

Image from Gyazo

ItemDescription
Field nameEnter the display name of the content editing screen.
SlugEnter the slug.
ResourceSpecify the directory path you want to display when ckfinder is launched.
Example: /files/user/
AnnotationEnter an annotation.

Field settings - Input restriction

Image from Gyazo

ItemDescription
Required settingWhen enabled, it becomes a required input.

Field settings - Custom template

Image from Gyazo

ItemDescription
Template editorUsed when you want to change the display of the content editing screen.

JSON Response

details: {
"ext_X":"https://sample.g.kuroco-img.app/v=1621239477/files/user/sample.png",
},

Video (Vimeo)

Video(Vimeo) is available after integration with Vimeo. Please refer to the following document for details on how to work with Vimeo.
How to Connect to Vimeo and Upload Videos

Display of the Content Editing Screen

Image from Gyazo

Field settings - General

Image from Gyazo

ItemDescription
Field nameEnter the display name of the content editing screen.
SlugEnter the slug.
AnnotationEnter the annotation.

Field settings - Input restriction

Image from Gyazo

ItemDescription
Required settingWhen enabled, it becomes a required input.
Allowed file extensionSpecify the file extensions allowed for upload.
Example: mp4

If not specified, there are no restrictions on the Kuroco side. However, the file extensions available on Vimeo are generally as follows: 3GP, AVI, MOV, MP4, MPG, MTS, M2TS

Field settings - Custom template

Image from Gyazo

ItemDescription
Template editorUsed when you want to change the display of the content editing screen.

JSON Response

details: {
"ext_col_14": {
"id": "sample_0",
"url": "https://player.vimeo.com/video/xxxxxxxxx",
"desc": "",
"image_url": "https://sample.g.kuroco-img.app/v=1234567890/files/topics/sample_0.jpg"
},
}

Others

API field

API fields are used to utilize response data from the specified endpoints. For detailed configuration instructions, refer to Setting up API Fields for Current Weather Input with OpenWeatherMap.

Display of Content Editing Screen

Image from Gyazo

Field settings - General

Image from Gyazo

Image from Gyazo

ItemDescription
Field nameEnter the display name of the content editing screen.
SlugEnter the slug.
Dialog headerSpecify the main title displayed in the popup window.
[pop_up] webhookWhen the popup window is displayed, send a webhook to the specified URL and create the column selection state with the value stored in the response data.
The items to be sent are as follows:
- topics_id: Strings
- hash: Strings
- value: Strings
The response should be received in the format {"data":["127", "18", "628"]}, with the values in the array becoming the values specified in the "Save Value" for each column.
[on_select] webhookSend a webhook to the specified URL when the final column is selected.
The items to be sent are as follows:
- topics_id: Strings
- hash: Strings
- selected_date: Array
- value_list: Array
[on_save] webhookWhen [Select] is clicked, send a webhook to the specified URL and save the value from the data in the webhook instead of the "Save Value".
The items to be sent are as follows:
- topics_id: Strings
- hash: Strings
- selected_date: Array
- value_list: Array
The response should be received in the format {"data":{"value":"668","display_value":"668"}}.
API Settings - TitleSpecify the item title in the popup window.
API Settings - URLSpecify the endpoint to be used in the popup window. The response data from the previous column can be used in the format %key%.
API Settings - Path to listSpecify the fields to be used from the response data.
API Settings - Saved formatSet the data to be saved when [Select] is clicked. The response data can be used in the format %key%.
API Settings - Display formatSet the data to be displayed in the popup window. The response data can be used in the format %key%.
API Settings - Preview URLSpecify the URL to be used for preview display. The response data can be used in the format %key%. The URL must allow display in an iframe.
AnnotationEnter a annotation.

Field settings - Input restriction

Image from Gyazo

ItemDescription
Required settingWhen enabled, it becomes a required input.

Field settings - Custom template

Image from Gyazo

ItemDescription
Template editorUsed when you want to change the display of the content editing screen.

Image from Gyazo

JSON Response

details: {
"ext_X":"Selected value",
},

Counter

The counter can be increased or decreased in value by hitting the Topics::increment endpoint.   This is used to set the number of PV number etc.   Implementing view-based page rankings in Google Analytics

Display of Content Editing Screen

Image from Gyazo

Field settings - General

Image from Gyazo

ItemDescription
Field nameEnter the display name of the content editing screen.
SlugEnter the slug.
AnnotationEnter a annotation.

Field settings - Input restriction

None

Field settings - Search settings

Image from Gyazo

ItemDescription
IndexingWhen enabled, an index is added to the database, resulting in faster search results and responses.

Field settings - Custom template

None

JSON Response

details: {
"ext_X": X,
},

Display of Content Editing Screen

Image from Gyazo

Field settings - General

Image from Gyazo

ItemDescription
Field nameEnter the display name of the content editing screen.
SlugEnter the slug.
AnnotationEnter the Annotation.

Field settings - Input restriction

Image from Gyazo

ItemDescription
Required settingWhen enabled, it becomes a required input.

Field settings - Custom template

Image from Gyazo

ItemDescription
Template editorUsed when you want to change the display of the content editing screen.

JSON Response

details: {
"ext_X": {
"url": "https://kuroco.app/",
"title": "Kuroco"
},
},

Number

Display of Content Editing Screen

Image from Gyazo

Field settings - General

Image from Gyazo

ItemDescription
Field nameEnter the display name of the content editing screen.
SlugEnter the slug.
AnnotationEnter the Annotation.

Field settings - Input restriction

Image from Gyazo

ItemDescription
Required settingWhen enabled, it becomes a required input.
Numeric value rangeSet the minimum and maximum values.
Input restrictionYou can restrict the input to a specific range of numbers.

Field settings - Search settings

Image from Gyazo

ItemDescription
IndexingWhen enabled, an index is created in the database, resulting in faster search results and responses.

Field settings - Custom template

None

JSON Response

details: {
"ext_X":123,
},

Table

Display of Content Editing Screen

Image from Gyazo

Field settings - General

Image from Gyazo

ItemDescription
Field nameEnter the display name of the content editing screen.
SlugEnter the slug.
Number of rowsSpecify the number of rows in the table.
Number of columnsSpecify the number of columns in the table.
Cell settingsEnter the value of the cell.
To specify the cell in the second row from the top and the third column from the left, write 2-3.
The automatically added header row will be the 0th row.
AnnotationEnter a annotation.

Field settings - Input restriction

Image from Gyazo

ItemDescription
Required settingWhen enabled, it becomes a required input.

Field settings - Custom template

Image from Gyazo

ItemDescription
Template editorUsed when you want to change the display of the content editing screen.

JSON Response

details: {
"ext_X": {
"1": {
"1": "1-1",
"2": "1-2",
"3": "1-3"
},
"2": {
"1": "2-1",
"2": "2-2",
"3": "2-3"
}
},
},

Location

Display of Content Editing Screen

Image from Gyazo

Field settings - General

Image from Gyazo

Image from Gyazo

ItemDescription
Field nameEnter the display name of the content editing screen.
SlugEnter the slug.
DefaultSets the default view of the map.
AnnotationEnter a annotation.

Field settings - Input restriction

Image from Gyazo

ItemDescription
Required settingWhen enabled, it becomes a required input.

Field settings - Custom template

Image from Gyazo

ItemDescription
Template editorUsed when you want to change the display of the content editing screen.

JSON Response

details: {
"ext_X": {
"gmap_x": "139.7435938",
"gmap_y": "35.7009012",
"gmap_zoom": "16",
"gmap_type": "roadmap",
"gmap_place_id": "ChIJbSFfyl2MGGARIoFxX2bg0hE",
"jp_lon": "139.0.11.2",
"jp_lat": "34.59.48.2"
},
},

Support

If you have any other questions, please contact us or check out Our Slack Community.