Automatic Insertion Before Paragraph
This page demonstrates Ad Inserter automatic insertion before paragraph. We’ll insert ads before the second paragraph, before the paragraph in the middle of the post and before the last paragraph.
Paragraph is a section of text between listed tags (normally only <p>
tags are counted). Paragraph counting can be from the top (default) or from the bottom of the page. You can also define what is counted as paragraph (button Counting) and where to avoid insertion (button Clearance), but for this demo we’ll use default values.
Paragraph number(s):
- value 1 or more means paragraph number
- negative value -1 or less means paragraph number counted from the opposite direction as configured
- value between 0 and 1 means relative position in post or page (e.g. 0.3 means paragraph 30% from top or bottom)
- 0 means random paragraph position
- %N means insertion every N paragraphs
- Empty value means all paragraphs – use Filter to define insertions
Paragraphs are not counted inside special elements: <blockquote>, <figure>, <li>
. Of course, there is an option to enable counting also inside these special elements and you can define these special elements – No Paragraph Counting Inside setting on the tab ⚙ / tab General.
Paragraph processing works on every post or page according to the settings. Therefore, if you enable insertion also on blog pages (home, category, archive, search pages) and your theme does not display post excerpts but complete posts, Ad Inserter will by default insert code blocks into ALL posts on the blog page (according to the settings).
Each code block you insert in the post adds one <div>
element (with your code) unless you use No wrapping style. This is important if you count also <div>
elements as paragraphs.
Before Paragraph automatic insertion will insert code before the opening paragraph <tag>
, After Paragraph automatic insertion will insert code after the closing paragraph </tag>
.
After Paragraph automatic insertion will work even if you specify tag names that have no closing tags (e.g. images using <img>
tag) since Ad Inserter uses special processing for such cases.
If you are inserting the same ad on multiple positions on posts (with the same counting and clearance settings) use one code block and specify all paragraph numbers. This will speed up insertion as the post will be processed only once.
The text below (Settings used) is wrapped with a <div>
and the plugin is configured to not count paragraphs inside <div>
elements.
Settings used
Whe have inserted all three ads with only one block with automatic insertion set to Before paragraph and paragraph numbers 2, 0.5, -1:
- 2 means before the second paragraph
- 0.5 means before the paragraph at 50% of the post
- -1 means before the first paragraph from the bottom (before the last paragraph)
We could achieve the same result with automatic insertion After Paragraph and paragraph numbers: 1, 0.5, -2. In this case only the middle ad would be inserted one paragraph lower, but still in the middle of the post.