Technical Reference

Neut Widget WordPress Reference

Use this reference after the WordPress quickstart is working. It lists the widgets supported by the Neut Widgets plugin, the available shortcodes and blocks, accepted attributes, and the supported subject, status, and colorway values.

Start with WordPress Quickstart if you have not yet installed and configured the plugin.

For non-WordPress implementations, see the Customer Widget Quickstart, Customer Widget Reference, and Customer Widget Backend Guide.

Supported Widgets

Widget	Widget ID
Bill Preview	`bill-preview`
Vote Breakdown	`vote-breakdown`
Legislation By Subject	`legislation-by-subject`

The plugin uses the Neut production widget host automatically:

https://widgets.neut.us

Customers do not need to configure that manually.

Supported Blocks

Block Title	Block Name
Bill Preview	`neut/bill-preview`
Vote Breakdown	`neut/vote-breakdown`
Legislation By Subject	`neut/legislation-by-subject`

Supported Shortcodes

Widget	Shortcode
Bill Preview	`[neut_bill_preview ...]`
Vote Breakdown	`[neut_vote_breakdown ...]`
Legislation By Subject	`[neut_legislation_by_subject ...]`

Common Rules

instance_id is required for every widget.
instance_id may contain only letters, numbers, dot, underscore, colon, or hyphen.
instance_id must be 128 characters or fewer.
congress, page, limit, bill_number, and district must be positive integers when provided.
colorway defaults to Default if omitted.

Bill Preview

Use this widget when the page is about a specific bill.

Shortcode:

[neut_bill_preview ...]

`instance_id`

Type: string
Required: Yes
Example: bill-preview-article-123-main

Unique widget placement ID.

`bill_type`

Type: string
Required: Yes
Example: HR

Bill type.

`bill_number`

Type: integer
Required: Yes
Example: 1

Positive bill number.

`congress`

Type: integer
Required: Yes
Example: 119

Positive Congress number.

`article_id`

Type: string
Required: No
Example: article-123

Optional tracing value.

`temp_text_url`

Type: string
Required: No
Example: https://www.congress.gov/119/bills/hr1/BILLS-119hr1ih.pdf

Must be a valid https URL.

`temp_title`

Type: string
Required: No
Example: Sample Bill Title

Fallback title for same-day bill coverage.

`colorway`

Type: string
Required: No
Example: Default

Optional style selection.

Bill Preview Example

[neut_bill_preview
  instance_id="bill-preview-article-123-main"
  bill_type="HR"
  bill_number="1"
  congress="119"
  article_id="article-123"
  colorway="Default"]

Vote Breakdown

Use this widget to show House roll call votes for a representative, or a general House roll call feed.

Shortcode:

[neut_vote_breakdown ...]

`instance_id`

Type: string
Required: Yes
Example: vote-breakdown-lofgren-ca-18

Unique widget placement ID.

`congress`

Type: integer
Required: Yes
Example: 119

Positive Congress number.

`page`

Type: integer
Required: No
Example: 1

Defaults to 1 if omitted.

`limit`

Type: integer
Required: No
Example: 5

Defaults to 10 if omitted.

`member_type`

Type: string
Required: Conditional
Example: Representative

Must currently be Representative when targeting a single member.

`last_name`

Type: string
Required: Conditional
Example: Lofgren

Required only when targeting a single member.

`state_code`

Type: string
Required: Conditional
Example: CA

Required only when targeting a single member. Must be a two-letter code.

`district`

Type: integer
Required: No
Example: 18

Allowed only for Representative.

`colorway`

Type: string
Required: No
Example: Paper

Optional style selection.

`show_member_hero`

Type: boolean
Required: No
Example: true

Optional display flag.

Vote Breakdown Member Rules

To target a single member, provide member_type, last_name, and state_code together.
For representatives, district is optional.
For a general House roll call feed, omit member_type, last_name, state_code, and district together.
vote-breakdown currently supports House roll call votes only. Senate recorded votes are not available in this widget yet.

Vote Breakdown Examples

Representative example:

[neut_vote_breakdown
  instance_id="vote-breakdown-lofgren-ca-18"
  member_type="Representative"
  last_name="Lofgren"
  state_code="CA"
  district="18"
  congress="119"
  limit="5"
  colorway="Paper"]

General feed example:

[neut_vote_breakdown
  instance_id="vote-breakdown-general-feed"
  congress="119"
  limit="5"
  colorway="Paper"]

Legislation By Subject

Use this widget on an issue or policy page, either for a single member or for general legislation on that subject.

Shortcode:

[neut_legislation_by_subject ...]

`instance_id`

Type: string
Required: Yes
Example: legislation-lofgren-health

Unique widget placement ID.

`congress`

Type: integer
Required: Yes
Example: 119

Positive Congress number.

`page`

Type: integer
Required: No
Example: 1

Defaults to 1 if omitted.

`limit`

Type: integer
Required: No
Example: 10

Defaults to 10 if omitted.

`subject`

Type: string
Required: Yes
Example: Health & Social Welfare

Must match a supported subject.

`status_filter`

Type: string
Required: No
Example: All

Defaults to All if omitted.

`member_type`

Type: string
Required: Conditional
Example: Representative

Must be Representative or Senator when targeting a single member.

`last_name`

Type: string
Required: Conditional
Example: Lofgren

Required only when targeting a single member.

`state_code`

Type: string
Required: Conditional
Example: CA

Required only when targeting a single member. Must be a two-letter code.

`district`

Type: integer
Required: No
Example: 18

Allowed only for Representative. Omit for senators.

`colorway`

Type: string
Required: No
Example: WashedSage

Optional style selection.

`show_member_hero`

Type: boolean
Required: No
Example: true

Optional display flag.

`show_subject_filter`

Type: boolean
Required: No
Example: false

Optional display flag.

`show_status_filter`

Type: boolean
Required: No
Example: false

Optional display flag.

Legislation By Subject Member Rules

To target a single member, provide member_type, last_name, and state_code together.
For representatives, district is optional.
For senators, omit district.
For a general subject view, omit member_type, last_name, state_code, and district together.

Legislation By Subject Examples

Representative example:

[neut_legislation_by_subject
  instance_id="legislation-lofgren-health"
  member_type="Representative"
  last_name="Lofgren"
  state_code="CA"
  district="18"
  congress="119"
  subject="Health & Social Welfare"
  status_filter="All"
  show_subject_filter="false"
  show_status_filter="false"
  limit="10"
  colorway="WashedSage"]

General subject example:

[neut_legislation_by_subject
  instance_id="legislation-health-general"
  congress="119"
  subject="Health & Social Welfare"
  status_filter="All"
  limit="10"
  colorway="WashedSage"]

Supported Subjects

Use one of these values for subject:

All
Animals & Agriculture
Business & Trade
Crime
Culture and Society
Education
Energy & Conservation
Finance & Taxes
Geopolitics
Government Operations
Health & Social Welfare
Human, Civil, & Immigration Rights
Infrastructure & Housing
Labor & Employment
National Security & International Affairs
STEM

Supported Status Filters

Use one of these values for status_filter:

All
Introduced
With First Chamber
With Second Chamber
Presented to President
Became Law
Vetoed by President
Passed Resolutions

Supported Colorways

Use one of these values for colorway:

Default
Dark
Paper
WashedSage
Slate
MonoLight

The plugin also accepts these aliases:

dark-mode
washed-sage
mono-light