Update blog settings
Tool ID: kocodesk_blog_settings_update
Summary
Change where the blog lives, how article URLs are built, the RSS path, the blog category root, or how many posts show per page.
When to use it
- When moving the blog to a different path.
- When you want dated article URLs instead of plain slugs.
What you need
| Requirement | Required? |
|---|---|
| Metraclick connection | Yes |
| Tool enabled for your account | Yes |
| KocoDesk credentials | Yes |
| Blog plugin enabled for the site | Yes |
Parameters
| Parameter | Required? | Description |
|---|---|---|
confirm |
Yes | Must be true; nothing changes without it. |
home_path |
No | Blog index path, for example /blog. |
url_pattern |
No | Article path after the blog index. Use {year}, {month}, {day} and {slug}. |
rss_path |
No | RSS feed path, for example /blog/rss. |
category_root_id |
No | Category used as the blog tree root (0 turns it off). |
posts_per_page |
No | Posts per index page, 1 to 100. |
What you get back
The full settings after the change, so you can check the result.
Example prompts
Change my blog article URLs to include the year and month, then confirm with me first.
Move the blog to /news and set 20 posts per page. Ask me to confirm.
Set the blog RSS feed path to /news/feed after I confirm.
Tips
- Mutating — you must confirm.
- Changing
home_pathorurl_patternchanges the address of every existing post, which can break links and search rankings. - Invalid paths are quietly replaced with defaults rather than rejected, so always read the returned settings to see what was actually saved.