Repository navigation
Shortcode attributes
github-actions[bot] edited this page Nov 18, 2026
·
1 revision
Written against v1.4.5.4.
Every attribute [uamswp_news] accepts, grouped by what it controls. All are optional. An attribute not listed here is dropped. The defaults are declared in $defaults_atts in includes/class-uams-syndicate-shortcode-base.php, and the uamswp_content_syndicate_default_atts filter can change them site-wide (Filters and actions).
Example:
[uamswp_news site="https://news.example.org/research/" output="excerpts" count="3" site_category_slug="awards" date_format="M j"]
| Attribute | Default | Effect |
|---|---|---|
site |
empty | Host name and path of the source site, such as https://news.example.org/research/. Overrides host when set. |
host |
the plugin's built-in news host | Host name of the source site, used when site is empty. A host with no usable host name prints the error comment described in Troubleshooting. |
query |
posts |
The REST route after wp-json/wp/v2/, such as pages. Query arguments can be included (posts?orderby=title). |
scheme |
https |
Accepted for compatibility; it does not change the request. The scheme comes from the routing in What the plugin does. |
| Attribute | Default | Effect |
|---|---|---|
site_category_slug |
empty | Comma-separated category slugs, sent as filter[category_name]. |
advanced_cat |
empty | Comma-separated category IDs, a negative ID excluding that category, sent as filter[cat]. |
tag |
empty | Comma-separated tag slugs, sent as filter[tag]. |
id |
empty | Comma-separated post IDs, sent as filter[p]. |
The source site must support the filter parameter for these to work: Filtering by category, tag or post.
| Attribute | Default | Effect |
|---|---|---|
count |
not set | How many posts to show. Not set, the source's own page size applies (10 on a default WordPress site). One request asks for at most 100. |
offset |
0 |
How many of the newest posts to skip in the printed formats. Set count with it: Splitting a feed across two lists. |
local_count |
0 |
How many posts to merge in through this site's REST API. With the stock shortcode it has no effect on a list from another site: What the plugin does. |
| Attribute | Default | Effect |
|---|---|---|
output |
json |
json, headlines, excerpts, cards or full: Output formats. Any other value prints nothing. |
object |
json_data |
Name of the JavaScript variable that output="json" assigns. |
date_format |
F j, Y |
PHP date format for the date shown by excerpts, the only format that shows one. |
style |
empty | Accepted, but no format uses it. |
| Attribute | Default | Effect |
|---|---|---|
cache_bust |
empty | Never read. Changing it changes the cache key of a remote list, forcing a new request: Getting fresh content. |
Getting started | Guides | Reference | Troubleshooting | README | Repository
Written against v1.4.5.4. Edit these pages in docs/wiki/ through a pull request; edits made here are overwritten.
Getting started
Guides
Reference
Troubleshooting