WP Smart Content

💡 Use Cases

• Add a script to the <head> section without editing theme files.
• Insert HTML into the <footer> for custom notices or widgets.
• Push CSS before WordPress outputs styles for precise control.
• Inject a notice after post content using Block Hooks.
• Manage analytics or marketing tags centrally, without touching templates.
• Schedule snippets to run only during campaigns or seasonal events.
• Delegate Safe Mode CSS editing to a designer or contributor without exposing Raw Mode or sensitive site access.
• Display region-specific banners or compliance notices using geotargeting (include/exclude selected countries).
• Control visibility across frontend, posts, pages, admin, authentication, or system pages with scope targeting.

🔗 Few Supported Hooks

Classic Hooks

• wp_head – Injects content into the ‘<head>’ section before closing tag
• wp_footer – Injects content into the ‘<body>’ section before closing tag
• wp_print_styles – Injects content before WordPress outputs enqueued styles
• wp_print_scripts – Injects content before WordPress outputs enqueued scripts
• wp_meta – Injects content into the meta section of the sidebar
• wp_print_footer_scripts – Injects content before WordPress outputs footer scripts

Block Hooks (WordPress 6.8+)

• after_post_content – Injects content immediately after the post content block
• before_post_content – Injects content immediately before the post content block
• after_comments – Injects content after the comments block
• before_comments – Injects content before the comments block
• after_entry_title – Injects content after the entry/post title block
• before_entry_title – Injects content before the entry/post title block

Optional Context Hooks

• admin_head – Injects content into the ‘<head>’ section of admin pages
• admin_footer – Injects content into the ‘<footer>’ section of admin pages
• login_head – Injects content into the ‘<head>’ section of the login page
• login_footer – Injects content into the ‘<footer>’ section of the login page
• enqueue_block_assets – Injects content when block editor assets are loaded

Usage

Administrators have access to both Raw and Safe modes. Trusted non-administrators can be granted access to pre-created blocks in Safe mode by assigning the ‘wpsc_admin’ capability to their role, either through a role editor plugin or via custom code.

Creating Blocks in WordPress Admin (From the plugin dashboard)

1. 01Install and activate WP Smart Content from the WordPress Plugins screen.
2. 02Go to WP Smart Content → Add New Block in the admin menu.
3. 03Enter a descriptive block name.
4. 04Paste your HTML, CSS, or JavaScript into the respective tabs of the block editor.
5. 05Select the desired mode: Raw Mode (unfiltered output) or Safe Mode (sanitized injection).
6. 06Choose where to inject the block, such as: Header (wp_head) for scripts or tracking code
7. 07Footer (wp_footer) for notices or widgets
8. 08Before/after post content for banners or messages
9. 09Block Hooks (WordPress 6.8+) for precise placement in the block editor
10. 10Other classic hooks such as wp_print_scripts or wp_meta
11. 11Configure targeting options: Apply globally (All) or across specific site sections (Frontend, All Posts, All Pages, Backend, Authentication, System Pages) using Target Scopes
12. 12Restrict visibility to selected posts or pages
13. 13Set priority to control execution order when multiple blocks use the same hook.
14. 14Define scheduling by assigning start and end dates so snippets appear only when needed.
15. 15Configure geotargeting to display blocks based on inclusion or exclusion of selected countries.
16. 16Enable revision saving by checking the “Save to revisions” option.
17. 17Publish the block.
18. 18Result: Your scripts, styles, or HTML are injected as configured. Blocks can be managed from the block listing — edit, enable/disable, publish/unpublish, or delete anytime.

Using the Block Editor to Insert Blocks (Placing directly into templates)

1. 19Once WP Smart Content is activated, open the Site Editor (Appearance → Editor) for your block theme.
2. 20Locate Block Hook areas (header, footer, before/after post content, sidebar).
3. 21From the block inserter (+), add the “WP Smart Content” block or select an existing block to edit its injection hook.
4. 22Use WP Smart Content settings in the right sidebar (Block tab) to select an injection hook. This links your stored block snippet to the chosen hook.
5. 23Save the template. Your snippet will be injected automatically at the chosen location.
6. 24Result: Scripts, styles, or HTML from the block editor are added via the Block UI without editing theme files, fully compatible with block themes.

Using Shortcodes to Insert Blocks (Place inline within posts, pages, or widgets)

1. 25Place the shortcode directly in your post, page, or widget: [wp_smart_content name="blockname"]
2. 26Replace “blockname” with the name of your Smart Content block.
3. 27Result: Scripts, styles, or HTML from the block editor are added at the exact position where the shortcode is placed, respecting publish status, scheduling, and geotargeting.
4. 28Example: [wp_smart_content name=”header-banner”] → This will display the “Header Banner” block inline inside your post or page content.

Geotargeting Setup Notes

WP Smart Content provides geotargeting support using two options:

1. 29Default (Country.is API) No setup required.
2. 30Uses the free Country.is API to detect visitor country by IP.
3. 31Ideal for lightweight use cases such as banners, compliance notices, or regional campaigns.
4. 32Fallback / Advanced (MaxMind GeoLite2 Database) For users who prefer to store IP data locally.
5. 33Requires the GeoLite2 Country database (MMDB format) created and licensed by MaxMind.
6. 34Due to licensing restrictions, the database cannot be redistributed within this plugin.
7. 35Users must download and update the database directly from MaxMind.

Steps to enable MaxMind fallback:

1. 36Create a free account at https://www.maxmind.com.
2. 37Download the GeoLite2 Country database (MMDB format).
3. 38After downloading the GeoLite2 Country database (GeoLite2-Country.mmdb), place the file here: /wp-content/plugins/wp-smart-content/maxmind-db-reader/data/GeoLite2-Country.mmdb
4. 39Update the database regularly as required (MaxMind releases monthly updates).

Result: – By default, WP Smart Content uses Country.is for geotargeting. – If the MaxMind database is present at the path above, the plugin will use it instead, allowing local IP lookups and more control over data storage. – If both methods fail, WP Smart Content defaults to rendering content to avoid breaking site functionality.

Credits

This plugin bundles the following third-party libraries:

• Tagify (https://github.com/yairEO/tagify) Released under the MIT License Copyright (c) Panayiotis Lipiridis
• Flag Icons (https://github.com/lipis/flag-icons) Released under the MIT License Copyright (c) Panayiotis Lipiridis
• MaxMind DB Reader (https://github.com/maxmind/MaxMind-DB-Reader-php) Released under the Apache License, Version 2.0 Copyright (c) MaxMind, Inc. Used to read GeoLite2 databases for geotargeting support. GeoLite2 data created by MaxMind, available from https://www.maxmind.com.

Licensing Notes

• This plugin itself is licensed under GPLv2 or later, in accordance with WordPress.org requirements.
• Tagify remains under its original MIT License. The MIT license file is included in this plugin’s distribution.
• Flag Icons remains under its original MIT License. The MIT license file is included in this plugin’s distribution.
• MaxMind DB Reader is licensed under the Apache License, Version 2.0. The Apache 2.0 license file is included in this plugin’s distribution.