Contents
Schema #
The schema defines all the fields that exist within a sfwd course record. Any response from these endpoints can be expected to contain the fields below unless the `_filter` query parameter is used or the schema field only appears in a specific context.
datestring, null, datetime (details) |
The date the object was published, in the site's timezone. Context: |
date_gmtstring, null, datetime (details) |
The date the object was published, as GMT. Context: |
guidobject |
The globally unique identifier for the object. Read only Context: |
idinteger |
Unique identifier for the object. Read only Context: |
linkstring, uri |
URL to the object. Read only Context: |
modifiedstring, datetime (details) |
The date the object was last modified, in the site's timezone. Read only Context: |
modified_gmtstring, datetime (details) |
The date the object was last modified, as GMT. Read only Context: |
slugstring |
An alphanumeric identifier for the object unique to its type. Context: |
statusstring |
A named status for the object. Context: One of: |
typestring |
Type of Post for the object. Read only Context: |
passwordstring |
A password to protect access to the content and excerpt. Context: |
permalink_templatestring |
Permalink template for the object. Read only Context: |
generated_slugstring |
Slug automatically generated from the object title. Read only Context: |
titleobject |
The title for the object. Context: |
contentobject |
The content for the object. Context: |
authorinteger |
The ID for the author of the object. Context: |
featured_mediainteger |
The ID of the featured media for the object. Context: |
menu_orderinteger |
The order of the object in relation to other object of its type. Context: |
templatestring |
The theme file to use to display the object. Context: |
categoriesarray |
The terms assigned to the object in the category taxonomy. Context: |
tagsarray |
The terms assigned to the object in the post_tag taxonomy. Context: |
ld_course_categoryarray |
The terms assigned to the object in the ld_course_category taxonomy. Context: |
ld_course_tagarray |
The terms assigned to the object in the ld_course_tag taxonomy. Context: |
course_materialshtml |
Course Materials Context: |
course_price_typestring |
Course Price Type Context: One of: |
custom_button_labeltext |
Custom Button Label Context: |
custom_button_urltext |
Custom Button URL Context: |
course_pricetext |
Course Price Context: |
course_prerequisite_enabledboolean |
Enable Course Prerequisites Context: |
course_prerequisitearray |
Course Prerequisites Context: |
course_prerequisite_comparestring |
Course Prerequisites Compare Context: One of: |
course_points_enabledboolean |
Enable Course Points Context: |
course_pointsnumber |
Course Points Context: |
course_points_accessnumber |
Course Points Access Context: |
course_disable_lesson_progressionboolean |
Disable Lesson Progression Context: |
expire_accessboolean |
Expire Access Context: |
expire_access_daysnumber |
Expire Access After (days) Context: |
expire_access_delete_progressboolean |
Delete Course and Quiz Data After Expiration Context: |
List Sfwd Courses #
Query this endpoint to retrieve a collection of sfwd courses. The response you receive can be controlled and filtered using the URL query parameters below.
Definition #
GET /ldlms/v1/sfwd-courses
Example Request #
$ curl https://example.com/wp-json/ldlms/v1/sfwd-courses
Arguments #
context |
Scope under which the request is made; determines fields present in response.
Default: One of: |
page |
Current page of the collection.
Default: |
per_page |
Maximum number of items to be returned in result set.
Default: |
search |
Limit results to those matching a string. |
after |
Limit response to posts published after a given ISO8601 compliant date. |
author |
Limit result set to posts assigned to specific authors. |
author_exclude |
Ensure result set excludes posts assigned to specific authors. |
before |
Limit response to posts published before a given ISO8601 compliant date. |
exclude |
Ensure result set excludes specific IDs. |
include |
Limit result set to specific IDs. |
menu_order |
Limit result set to posts with a specific menu_order value. |
offset |
Offset the result set by a specific number of items. |
order |
Order sort attribute ascending or descending.
Default: One of: |
orderby |
Sort collection by object attribute.
Default: One of: |
slug |
Limit result set to posts with one or more specific slugs. |
status |
Limit result set to posts assigned one or more statuses.
Default: |
tax_relation |
Limit result set based on relationship between multiple taxonomies. One of: |
categories |
Limit result set to all items that have the specified term assigned in the categories taxonomy. |
categories_exclude |
Limit result set to all items except those that have the specified term assigned in the categories taxonomy. |
tags |
Limit result set to all items that have the specified term assigned in the tags taxonomy. |
tags_exclude |
Limit result set to all items except those that have the specified term assigned in the tags taxonomy. |
ld_course_category |
Limit result set to all items that have the specified term assigned in the ld_course_category taxonomy. |
ld_course_category_exclude |
Limit result set to all items except those that have the specified term assigned in the ld_course_category taxonomy. |
ld_course_tag |
Limit result set to all items that have the specified term assigned in the ld_course_tag taxonomy. |
ld_course_tag_exclude |
Limit result set to all items except those that have the specified term assigned in the ld_course_tag taxonomy. |
Create a Sfwd Course #
Arguments #
date |
The date the object was published, in the site's timezone. |
date_gmt |
The date the object was published, as GMT. |
slug |
An alphanumeric identifier for the object unique to its type. |
status |
A named status for the object. One of: |
password |
A password to protect access to the content and excerpt. |
title |
The title for the object. |
content |
The content for the object. |
author |
The ID for the author of the object. |
featured_media |
The ID of the featured media for the object. |
menu_order |
The order of the object in relation to other object of its type. |
template |
The theme file to use to display the object. |
categories |
The terms assigned to the object in the category taxonomy. |
tags |
The terms assigned to the object in the post_tag taxonomy. |
ld_course_category |
The terms assigned to the object in the ld_course_category taxonomy. |
ld_course_tag |
The terms assigned to the object in the ld_course_tag taxonomy. |
course_materials |
Course Materials |
course_price_type |
Course Price Type
Default: One of: |
custom_button_label |
Custom Button Label |
custom_button_url |
Custom Button URL |
course_price |
Course Price |
course_prerequisite_enabled |
Enable Course Prerequisites |
course_prerequisite |
Course Prerequisites |
course_prerequisite_compare |
Course Prerequisites Compare
Default: One of: |
course_points_enabled |
Enable Course Points |
course_points |
Course Points |
course_points_access |
Course Points Access |
course_disable_lesson_progression |
Disable Lesson Progression |
expire_access |
Expire Access |
expire_access_days |
Expire Access After (days) |
expire_access_delete_progress |
Delete Course and Quiz Data After Expiration |
Definition #
POST /ldlms/v1/sfwd-courses
Retrieve a Sfwd Course #
Definition & Example Request #
GET /ldlms/v1/sfwd-courses/<id>
Query this endpoint to retrieve a specific sfwd course record.
$ curl https://example.com/wp-json/ldlms/v1/sfwd-courses/<id>
Sample Response #
{
"id": 24,
"date": "2017-04-19T19:28:55",
"date_gmt": "2017-04-19T19:28:55",
"guid": {
"rendered": "http://example.com/academy/?post_type=sfwd-courses&p=24"
},
"modified": "2018-04-26T12:31:57",
"modified_gmt": "2018-04-26T19:31:57",
"slug": "in-practice",
"status": "publish",
"type": "sfwd-courses",
"link": "http://example.com/courses/in-practice/",
"title": {
"rendered": "In Practice: Practitioner Success Series"
},
"content": {
"rendered": "<h1> Course content</h1>",
"protected": false
},
"author": 12,
"featured_media": 394,
"menu_order": 0,
"template": "",
"categories": [
10
],
"tags": [
147,
145
],
"ld_course_category": [],
"ld_course_tag": [],
"course_materials": "",
"course_price_type": "free",
"custom_button_label": "",
"custom_button_url": "",
"course_price": "",
"course_prerequisite_enabled": "off",
"course_prerequisite": [],
"course_prerequisite_compare": "ANY",
"course_points_enabled": "",
"course_points": "0",
"course_points_access": "0",
"course_disable_lesson_progression": "on",
"expire_access": "",
"expire_access_days": "",
"expire_access_delete_progress": "",
"_links": {
"self": [
{
"href": "http://example.com/wp-json/ldlms/v1/sfwd-courses/24"
}
],
"collection": [
{
"href": "http://example.com/wp-json/ldlms/v1/sfwd-courses"
}
],
"about": [
{
"href": "http://example.com/wp-json/wp/v2/types/sfwd-courses"
}
],
"author": [
{
"embeddable": true,
"href": "http://example.com/wp-json/wp/v2/users/12"
}
],
"version-history": [
{
"count": 0,
"href": "http://example.com/wp-json/ldlms/v1/sfwd-courses/24/revisions"
}
],
"steps": [
{
"embeddable": true,
"href": "http://example.com/wp-json/ldlms/v1/sfwd-courses/24/steps"
}
],
"users": [
{
"embeddable": true,
"href": "http://example.com/wp-json/ldlms/v1/sfwd-courses/24/users"
}
],
"groups": [
{
"embeddable": true,
"href": "http://example.com/wp-json/ldlms/v1/sfwd-courses/24/groups"
}
],
"wp:featuredmedia": [
{
"embeddable": true,
"href": "http://example.com/wp-json/wp/v2/media/394"
}
],
"wp:attachment": [
{
"href": "http://example.com/wp-json/wp/v2/media?parent=24"
}
],
"wp:term": [
{
"taxonomy": "category",
"embeddable": true,
"href": "http://example.com/wp-json/wp/v2/categories?post=24"
},
{
"taxonomy": "post_tag",
"embeddable": true,
"href": "http://example.com/wp-json/wp/v2/tags?post=24"
},
{
"taxonomy": "ld_course_category",
"embeddable": true,
"href": "http://example.com/wp-json/wp/v2/ld_course_category?post=24"
},
{
"taxonomy": "ld_course_tag",
"embeddable": true,
"href": "http://example.com/wp-json/wp/v2/ld_course_tag?post=24"
}
],
"curies": [
{
"name": "wp",
"href": "https://api.w.org/{rel}",
"templated": true
}
]
}
}
Arguments #
id |
Unique identifier for the object. Required: 1 |
context |
Scope under which the request is made; determines fields present in response.
Default: One of: |
password |
The password for the post if it is password protected. |
Update a Sfwd Course #
Arguments #
id |
Unique identifier for the object. Required: 1 |
date |
The date the object was published, in the site's timezone. |
date_gmt |
The date the object was published, as GMT. |
slug |
An alphanumeric identifier for the object unique to its type. |
status |
A named status for the object. One of: |
password |
A password to protect access to the content and excerpt. |
title |
The title for the object. |
content |
The content for the object. |
author |
The ID for the author of the object. |
featured_media |
The ID of the featured media for the object. |
menu_order |
The order of the object in relation to other object of its type. |
template |
The theme file to use to display the object. |
categories |
The terms assigned to the object in the category taxonomy. |
tags |
The terms assigned to the object in the post_tag taxonomy. |
ld_course_category |
The terms assigned to the object in the ld_course_category taxonomy. |
ld_course_tag |
The terms assigned to the object in the ld_course_tag taxonomy. |
course_materials |
Course Materials |
course_price_type |
Course Price Type One of: |
custom_button_label |
Custom Button Label |
custom_button_url |
Custom Button URL |
course_price |
Course Price |
course_prerequisite_enabled |
Enable Course Prerequisites |
course_prerequisite |
Course Prerequisites |
course_prerequisite_compare |
Course Prerequisites Compare One of: |
course_points_enabled |
Enable Course Points |
course_points |
Course Points |
course_points_access |
Course Points Access |
course_disable_lesson_progression |
Disable Lesson Progression |
expire_access |
Expire Access |
expire_access_days |
Expire Access After (days) |
expire_access_delete_progress |
Delete Course and Quiz Data After Expiration |