Placements are like a channel or bucket – you assign individual underwriting announcements to a placement and insert that placement at different spots in the web site. Any underwriting announcements you assign to a certain placement show up anywhere that placement is inserted.
You can find placements under the “Web Underwriting” menu on the left click “Placements”
Adding a new placement
Enter the name of the placement and click “Add New Placement”
Editing a placement’s name
Hover over the placement name and click “Quick Edit”
Make your changes to the name and click “Update Placement”
Changing the name won’t affect any announcements assigned to this placement or any spots where the placement is used on the site
Inserting placements into the site
To show the announcements you assign to a placement, you need to add that placement somewhere on the site.
Please note, to display announcements anywhere on the site (using a placement), you must first make sure at least one placement has been added as described above.
There are three ways to add it (you can use any combination of these):
1. Automatic insertion
Under “Web Underwriting” go to “Settings”
Under “Automatically insert placements” click “Add Placement”
Configure the placement insertion
- Under “Placement” select the placement you want to insert
- Select an option under “At the beginning/end” to decide if the placement should be inserted at the beginning of the page (before the page’s content) or at the end (after the content)
- Choose types of content. Available options include posts, pages, and various archives (e.g., listings by category, tag, or date).
Note: if you decide to insert the placement into “Pages,” you can exclude the home page from that as a special case, to give more more control over where the underwriting announcements appear on the home page.
When you’ve added the placements you want, click “Update”
2. Block
There’s a custom block that lets you insert a placement on a page.
Edit a page built with blocks or enable the block editor.
Click the “+” icon in the upper left of the page or anywhere it appears within the page
In the resulting popup, start typing “announcement” to filter the available blocks and click on the “Announcement” block when it shows up.
The block will be blank by default.
Block settings
- Placement – Announcements assigned to the placement you choose here will be shown in this block
- Header – enter a block of text (or HTML) to go above the announcement list. If you don’t need it to disappear when there aren’t any announcements, it’s probably easier to just add a block with your header before the announcement block.
- When you enter something in the header field, you get a checkbox to “Hide header when there are no announcements in this block” which is the reason to use the header block at all – it can automatically go away if there aren’t any announcements, getting around the problem of a header over an empty section.
- Example template of the HTML for a typical “section heading” style header: <h4 class=”is-style-section-heading”>Happening at KTOO</h4>
- Space above – empty space (in pixels) above the list of announcements
- Space between announcements – empty space between each announcement in the list
- Divider between announcements – check this box to show a horizontal line between each announcement in the list
- Space below – empty space (in pixels) to display below the list of announcements)
- Make all headers the same size – check this box to force all headers in the list to show the same size, regardless of what Announcement Type they use
If you have an announcement assigned to the placement you selected, you should see a preview of it in the block (not necessarily styled how it will appear on the front end of the web site)
3. Widget
You can add underwriting widgets to sidebars via a widget
Under “Appearance” in the left-hand menu, select “Widgets”
In the left-hand list of available widgets, click on “Underwriting Announcements,” click on the sidebar (widget area) where you want to insert it, and click “Add Widget”
Find the “Underwriting Announcements” widget in the sidebar where you just added it
You can click on the title to expand or collapse the widget. You can click and drag on the “Underwriting Announcements” title to drag it up or down in the order compared to other widgets in the sidebar
Using the “Select a placement” dropdown, find the placement you want to display and click “Save.”
