About this plugin
This plugin helps you have more content on your website by providing blocks with positive, solutions-focused news headlines and teasers. All articles are thoroughly handpicked by the editorial team of Squirrel News. V.
The plugin provides three different blocks showing teasers of constructive news stories from a variety of different media sources, including links to the original articles on the websites of the corresponding media.
For this purpose they can choose among three Gutenberg blocks:
- Constructive News Card
- Constructive News Grid
- Constructive News List
V. and developed by Anouar Ben Hamza.
Getting started
To get started, activate the plugin, choose the language on the Constructive News settings page, then insert one of the Constructive News blocks into a post or page.
Language note: English and German content are fetched from completely different source pools and countries, so switching the language will change the geographic focus and sources of the articles.
Use of external service
This plugin is a service-based plugin.
It connects to an external content service to fetch article data:
- Endpoint: https://getarticlesforlastissues-mdlzfg63qq-uc.a.run.app
- Query parameters sent by the plugin: lang and limit, plus editor-only preview/cache parameters when blocks are previewed in wp-admin.
Without the external service response, the plugin cannot fetch fresh article content and does not work.
Service and Privacy Disclosure
This plugin performs outbound requests to the Squirrel News content service to retrieve article data.
V. and is used to deliver the curated article data shown by the plugin blocks.
The plugin sends requests to the external service whenever a Constructive News block is rendered and needs article data, including in the block editor preview and on the frontend.
Data sent to the service:
- The selected content language ( en or de )
- The requested article limit
- Technical request data sent by normal HTTP requests, such as the visitor IP address, user agent, and request timing
Why this data is sent:
- To request the correct article feed
- To return the requested number of curated articles
- To allow the remote service to respond and operate securely
Service links:
- Privacy Policy: https://squirrel-news.net/privacy-policy/
- Legal notice / service terms information: https://squirrel-news.net/imprint/
Plugin settings data stored locally in WordPress:
- Selected language ( en or de )
- Cached API payloads for performance/fallback
External links rendered on the frontend can point to:
- Squirrel News website
- Squirrel News support page
- Third-party publisher article URLs
Site owners should review and publish their own privacy disclosures as needed for their jurisdiction and site policy.
Development
The distributed plugin includes the original, human-readable source files used to build the JavaScript and CSS assets.
Included source and build files:
- src/ contains the original block editor and frontend source code
- build/ contains the compiled production assets used by WordPress
- package.json contains the build commands and dependencies
Build tools:
- npm
- @wordpress/scripts
To rebuild the generated assets:
- Run npm install
- Run npm run build
Developer Hooks
The plugin includes filters for customization without editing core files.
API filters:
* constructnews_api_lang
* constructnews_api_limit
* constructnews_api_payload
* constructnews_api_base_url
* constructnews_api_request_args
* constructnews_api_articles
Card block filters:
* constructnews_card_block_lang
* constructnews_card_labels
* constructnews_card_behavior_flags
* constructnews_card_styles
* constructnews_card_articles_prepared
* constructnews_card_display_articles
* constructnews_card_plan
Grid block filters:
* constructnews_grid_block_lang
* constructnews_grid_labels
* constructnews_grid_behavior_flags
* constructnews_grid_styles
* constructnews_grid_articles_prepared
* constructnews_grid_display_articles
* constructnews_grid_plan
List block filters:
* constructnews_list_block_lang
* constructnews_list_labels
* constructnews_list_behavior_flags
* constructnews_list_styles
* constructnews_list_articles_prepared
* constructnews_list_display_articles
* constructnews_list_plan
Example:
add_filter( 'constructnews_api_limit', function( $limit ) { return 10; } );