Contesimal

wondermentapps

Contesimal Connector adds REST API endpoints to your WordPress site, allowing external applications to create and manage content using an API key.

Requests are made to your site’s <code>/wp-json/contesimal/v1/</code> endpoints. The plugin does not send any data externally on its own.

External services and privacy

<ul>
<li>Service: Designed to work with Contesimal (https://contesimal.ai), but compatible with any client using your API key.</li>
<li>Data received: Post title, content (HTML), excerpt, status, categories, tags, post type, author ID, and media URLs. The optional users endpoint returns public-style author fields (ID, display name, slug) for users who can edit posts—no passwords or email.</li>
<li>Media handling: Your WordPress site may download remote files from provided URLs to create Media Library attachments.</li>
<li>When: Only when a valid API request is sent to your site. No background communication occurs.</li>
<li>Control: External access is enabled only if you share the API key. You can regenerate the key or deactivate the plugin at any time.</li>
<li>Consent: By enabling the plugin and sharing the API key, the site administrator allows external applications to submit content.</li>
</ul>

Authentication

All endpoints require an API key sent in the <code>X-API-Key</code> header (or <code>Authorization: Bearer</code>).

The key is:
– Generated on your site
– Stored as a secure hash
– Managed by administrators only

Requests without a valid key are rejected (401). Rate limiting is applied per IP.

API keys should be treated as sensitive credentials and only shared with trusted systems.

Features

<ul>
<li>API key authentication (hashed storage)</li>
<li>Create posts via REST API</li>
<li>List categories, post types, and author-capable users (IDs for <code>author_id</code>)</li>
<li>Media import from external URLs</li>
<li>Rate limiting (per IP)</li>
<li>Configurable CORS</li>
<li>Optional request logging (admin only)</li>
</ul>

REST endpoints (base: <code>/wp-json/contesimal/v1</code>)

<ul>
<li><code>GET /ping</code> – Health check</li>
<li><code>GET /categories</code> – List categories</li>
<li><code>GET /post-types</code> – List public post types</li>
<li><code>GET /users</code> – List users with <code>edit_posts</code> (optional <code>session_only</code>, <code>search</code>, <code>limit</code>)</li>
<li><code>GET /posts</code> – List posts by post type with pagination and total count</li>
<li><code>POST /publish</code> – Create post</li>
<li><code>POST /media/import</code> – Import media from URLs</li>
</ul>

An admin notice is shown when API access is enabled, indicating that external publishing is active.

<h3>REST API Reference</h3>

All endpoints require: <code>X-API-Key: your_api_key</code>

<h4>GET /wp-json/contesimal/v1/ping</h4>

Returns plugin status.

Response:
{ “status”: “ok”, “plugin”: “contesimal-connector”, “version”: “1.0.0” }

<h4>GET /wp-json/contesimal/v1/categories</h4>

Returns category list.

<h4>GET /wp-json/contesimal/v1/post-types</h4>

Returns public post types.

<h4>GET /wp-json/contesimal/v1/users</h4>

Returns users who can author posts (<code>edit_posts</code>), suitable for <code>author_id</code> on <code>POST /publish</code>.

Query parameters (all optional):




 Parameter
 Description




 search
 Substring match on login, nicename, or display name


 session_only
 <code>1</code> to only include users with stored WordPress session tokens (typically logged in recently)


 limit
 Max results, 1–200 (default 200)




Response (example):
{ “success”: true, “users”: [ { “id”: 1, “name”: “Site Admin”, “slug”: “admin” } ] }

<h4>GET /wp-json/contesimal/v1/posts</h4>

Returns a paginated list of posts for a given post type, plus the total count for that filter.

Query parameters (all optional):




 Parameter
 Description




 post_type
 Public post type (default <code>post</code>)


 per_page
 1–100, default 50


 offset
 Number of posts to skip (default 0)


 status
 Comma-separated status list (default <code>publish</code>), or <code>any</code>


 search
 Optional keyword across title/content




Response (example):
{ “success”: true, “post_type”: “post”, “total”: 124, “per_page”: 50, “offset”: 0, “count”: 50, “posts”: [ { “post_id”: 42, “title”: “Hello world”, “slug”: “hello-world”, “status”: “publish”, “date”: “2026-05-14T11:50:00+00:00”, “author_name”: “Site Admin”, “link”: “https://example.com/hello-world/”, “featured_image”: “https://example.com/wp-content/uploads/2026/05/cover.jpg”, “featured_image_id”: 99, “categories”: [ “News”, “Updates” ], “tags”: [ “Announcement”, “WordPress” ], “content”: “

Hello

” } ] }

<h4>POST /wp-json/contesimal/v1/publish</h4>

Creates a post.

Headers:
Content-Type: application/json 
X-API-Key: your_api_key

Body:




 Field
 Type
 Required
 Description




 title
 string
 Yes
 Post title


 content
 string
 Yes
 HTML content


 status
 string
 No
 publish, draft, pending, private


 excerpt
 string
 No
 Post excerpt


 post_type
 string
 No
 Default: post


 category_ids
 array
 No
 Category IDs


 tags
 array
 No
 Tag names


 featured_image_url
 string
 No
 Image URL


 author_id
 integer
 No
 Default: 1




Responses:
– 200 Success
– 400 Bad request
– 401 Invalid API key
– 429 Rate limit exceeded
– 500 Server error

Contesimal Connector

Publish content to WordPress from external applications via a secure REST API using API key authentication.

Pratik Shrestha

Sakin Shrestha

Catch Plugins

dreamsapana

Catch Themes

Mahesh Maharjan

Essential Content Types allows you to feature the impressive content through different content/post types on your website just the way you want it. These content/post types are missed by the themes in WordPress Theme Directory as the feature falls more towards the plugins’ territory.
Content is at the forefront of any website. Changing the layout of your important content changes the way your website looks, which may not be a plus point if your current website layout is loved by your users.
Additionally, switching themes changes your website layout completely. Therefore, to keep things looking spic-and- span in your website, we bring you Essential Content.
Essential Content allows you to add up to three content/post types: 
* Portfolio – Create and display your portfolio on your website 
* Testimonials – Add customer testimonials to your website 
* Featured Content – Display the content you want as featured content on your website to attract visitors’ attention 
* Services – Add your services on your website
Features of Essential Content: 
* Enable/Disable any content/post type as needed 
* Light-weight 
* Supports all themes on WordPress
Essential Content is inspired by Jetpack’s Custom Content Types feature.
However, not everyone wants to have a plugin that “does-it- all”. Some may want plugins to be niche focused and concentrate on smaller areas.
That is precisely what we have done with Essential Content. Essential content, true to its name, has only the essential elements. We have added the features that WordPressers use most. We have ruled out all other elements to make it non-bloated and clean. It takes up lesser space and does the job well.
If you think we have missed any essential content/post types, please let us know. We’ll review the frequency of usage and add your suggestions.
Portfolio Shortcode
You can use shortcodes to embed portfolio projects on posts and pages.
Embedding Portfolio Projects
To embed portfolio projects on posts and pages, first activate the Portfolio custom content type on your site and add some projects to your portfolio.
Next, add the <code>[portfolio]</code> shortcode to a post or page. The shortcode will display projects in different ways, depending on how you use the optional attributes to customize the portfolio layout.
Attributes 
* display_types: display Project Types. (true/false) 
* display_tags: display Project Tags. (true/false) 
* display_content: display project content. (true/false) 
* include_type: display specific Project Types. Defaults to all. (comma-separated list of Project Type slugs) 
* include_tag: display specific Project Tags. Defaults to all. (comma-separated list of Project Tag slugs) 
* columns: number of columns in shortcode. Defaults to 2. (number, 1-6) 
* showposts: number of projects to display. Defaults to all. (number) 
* order: display projects in ascending or descending order. Defaults to ASC for sorting in ascending order, but you can reverse the order by using DESC to display projects in descending order instead. (ASC/DESC) 
* orderby: sort projects by different criteria, including author name, project title, and even rand to display in a random order. Defaults to sorting by date. (author, date, title, rand)
Example
<pre><code>[portfolio display_types="true" display_tags="false" include_type="grooming-tips,best-kitties" columns="2" showposts="10" orderby="title"]
</code></pre>
The example will display up to ten portfolio projects in two columns, in ascending alphabetical order by project title. It will display Project Types, hide Project Tags, and only display projects that are assigned the “Grooming Tips” or “Best Kitties” Project Types.
Featured Content Shortcode
You can use shortcodes to embed featured content on posts and pages.
Embedding Featured Content Projects
To embed featured content on posts and pages, first activate the Featured Content content type on your site and add some projects to your featured content.
Next, add the <code>[featured_content]</code> shortcode to a post or page. The shortcode will display projects in different ways, depending on how you use the optional attributes to customize the featured content layout.
Attributes 
* display_types: display Content Types. (true/false) 
* display_tags: display Content Tags. (true/false) 
* display_content: display project content. (true/false) 
* include_type: display specific Content Types. Defaults to all. (comma-separated list of Content Type slugs) 
* include_tag: display specific Content Tags. Defaults to all. (comma-separated list of Content Tag slugs) 
* columns: number of columns in shortcode. Defaults to 2. (number, 1-6) 
* showposts: number of projects to display. Defaults to all. (number) 
* order: display projects in ascending or descending order. Defaults to ASC for sorting in ascending order, but you can reverse the order by using DESC to display projects in descending order instead. (ASC/DESC) 
* orderby: sort projects by different criteria, including author name, project title, and even rand to display in a random order. Defaults to sorting by date. (author, date, title, rand)
Example
<pre><code>[featured_content display_types="true" display_tags="false" include_type="grooming-tips,best-kitties" columns="2" showposts="10" orderby="title"]
</code></pre>
The example will display up to ten featured content in two columns, in ascending alphabetical order by project title. It will display Content Types, hide Content Tags, and only display projects that are assigned the “Grooming Tips” or “Best Kitties” Content Types.
Testimonials Shortcode
You can use shortcodes to embed testimonials on posts and pages. 
Embedding Testimonials
To embed testimonials on posts and pages, first activate the Testimonial custom content type on your site and add some testimonials.
Next, add the <code>[testimonials]</code> shortcode to a post or page. The shortcode will display testimonials in different ways, depending on how you use the optional attributes to customize the testimonials layout.
Attributes 
* display_content: display testimonial content. (full/true/false) 
* image: display the featured image. (true/false) Defaults to true. 
* columns: number of columns in shortcode. Defaults to 1. (number, 1-6) 
* showposts: number of testimonials to display. Defaults to all. (number) 
* order: display testimonials in ascending or descending chronological order. Defaults to ASC for sorting in ascending order, but you can reverse the order by using DESC to display testimonials in descending order instead. (ASC/DESC) 
* orderby: sort testimonials by different criteria, including author name, testimonial title, and even rand to display in a random order. Defaults to sorting by date. (author, date, title, rand)
Example
<pre><code>[testimonials columns="2" showposts="10" orderby="title"]
</code></pre>
The example will display up to ten testimonials in two columns, in ascending alphabetical order by testimonial title.
Service Shortcode
You can use shortcodes to embed service on posts and pages.
Embedding Service Projects
To embed service on posts and pages, first activate the Service content type on your site and add some projects to your Service.
Next, add the <code>[services]</code> shortcode to a post or page. The shortcode will display projects in different ways, depending on how you use the optional attributes to customize the featured content layout.
Attributes 
* display_types: display Content Types. (true/false) 
* display_tags: display Content Tags. (true/false) 
* display_content: display project content. (true/false) 
* include_type: display specific Content Types. Defaults to all. (comma-separated list of Content Type slugs) 
* include_tag: display specific Content Tags. Defaults to all. (comma-separated list of Content Tag slugs) 
* columns: number of columns in shortcode. Defaults to 2. (number, 1-6) 
* showposts: number of projects to display. Defaults to all. (number) 
* order: display projects in ascending or descending order. Defaults to ASC for sorting in ascending order, but you can reverse the order by using DESC to display projects in descending order instead. (ASC/DESC) 
* orderby: sort projects by different criteria, including author name, project title, and even rand to display in a random order. Defaults to sorting by date. (author, date, title, rand)
Example
<pre><code>[services display_types="true" display_tags="false" include_type="grooming-tips,best-kitties" columns="2" showposts="10" orderby="title"]
</code></pre>
The example will display up to ten featured content in two columns, in ascending alphabetical order by project title. It will display Content Types, hide Content Tags, and only display projects that are assigned the “Grooming Tips” or “Best Kitties” Content Types.
Food Menu Shortcode
You can use shortcodes to embed Food Menu on posts and pages. 
Embedding Food Menu
Embedding Food Menu
To embed food menus on posts and pages, first activate the Food Menu custom content type on your site and add some food menus.
Next, add the <code>[food_menu]</code> shortcode to a post or page. The shortcode will display food menu in the selected post or page.
Attributes 
* showposts: number of menu items to display. Defaults to all. (number) 
* include_type: display specific Content Types. Defaults to all. (comma-separated list of Content Type slugs) 
* include_tag: display specific Content Tags. Defaults to all. (comma-separated list of Content Tag slugs)
Example
<pre><code>[food_menu showposts="10" include_type="pizza,burger,breakfast"]
</code></pre>
The example will display up to ten menu items. It will only display menu items in “Pizza”, “Burger” or “Breakfast” sections.
<h3>Translations</h3>
To translate the plugin, use translate.wordpress.org (GlotPress). You only need your WordPress.org account to join the collaborative translation project.
You can translate Essential Widgets on <a href="https://translate.wordpress.org/projects/wp-plugins/essential-content-types/" rel="nofollow ugc">translate.wordpress.org</a>.

Essential Content Types

Essential Content Types allows you to feature the impressive content through different content/post types on your website just the way you want it.

Contesimal Connector vs Essential Content Types