Skip to content

Complete HTTP data source tutorial with full working example#711

Draft
Copilot wants to merge 8 commits intotrunkfrom
copilot/finish-http-data-source-tutorial
Draft

Complete HTTP data source tutorial with full working example#711
Copilot wants to merge 8 commits intotrunkfrom
copilot/finish-http-data-source-tutorial

Conversation

Copy link
Contributor

Copilot AI commented Jan 21, 2026

The HTTP data source tutorial (docs/tutorials/http.md) was incomplete, ending abruptly after the "Register the block" section with only a brief mention of following another example.

Changes

Added missing sections and complete working code example to match structure of other tutorials (Airtable, Google Sheets, Shopify):

  • Register the block - Added complete working code example showing:
    • How to load data source by UUID using HttpDataSource::from_uuid()
    • Full query definition with input_schema, endpoint function, and output_schema
    • Complete register_remote_data_block() call with render_query
    • Clear explanation of what each part does
  • Insert the block - Instructions for using the block in the WordPress editor
  • Patterns and styling - Links to pattern documentation and theme customization
  • Code reference - Points to rest-api-block-from-ui-data-source example template

The code example is based on the zip-code-block and uses the Zippopotam.us API, providing a complete end-to-end working tutorial that users can follow to create their own HTTP data source blocks.

Original prompt

This section details on the original issue you should resolve

<issue_title>Finish HTTP data source tutorial</issue_title>
<issue_description>The "Create a remote data block using an HTTP data source" tutorial in the docs is incomplete.</issue_description>

Comments on the Issue (you are @copilot in this section)


💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

Copilot AI and others added 2 commits January 21, 2026 15:53
Co-authored-by: maxschmeling <112691+maxschmeling@users.noreply.github.com>
Co-authored-by: maxschmeling <112691+maxschmeling@users.noreply.github.com>
Copilot AI changed the title [WIP] Complete HTTP data source tutorial documentation Complete HTTP data source tutorial with missing sections Jan 21, 2026
Copilot AI requested a review from maxschmeling January 21, 2026 15:57
@maxschmeling
Copy link
Contributor

@copilot this still skips over the creation of a query. It should at least show a render query and how to add that. Without a query, you can't add a block for HTTP because RDB doesn't know what to generate. Include an example that will work end to end (for a fictional API).

Copilot AI and others added 5 commits January 21, 2026 19:47
Co-authored-by: maxschmeling <112691+maxschmeling@users.noreply.github.com>
Co-authored-by: maxschmeling <112691+maxschmeling@users.noreply.github.com>
Co-authored-by: maxschmeling <112691+maxschmeling@users.noreply.github.com>
Co-authored-by: maxschmeling <112691+maxschmeling@users.noreply.github.com>
Co-authored-by: maxschmeling <112691+maxschmeling@users.noreply.github.com>
Copy link
Contributor Author

Copilot AI commented Jan 21, 2026

@copilot this still skips over the creation of a query. It should at least show a render query and how to add that. Without a query, you can't add a block for HTTP because RDB doesn't know what to gen...

Added complete query example with input_schema, output_schema, endpoint function, and register_remote_data_block call. The code matches the zip-code-block example pattern and will work end-to-end for the Zip code API. See commit aed3a15.

Copilot AI changed the title Complete HTTP data source tutorial with missing sections Complete HTTP data source tutorial with full working example Jan 21, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Finish HTTP data source tutorial

2 participants