{"id":244979,"date":"2025-08-09T12:54:58","date_gmt":"2025-08-09T12:54:58","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/terovania-steam-integration\/"},"modified":"2025-08-14T19:58:22","modified_gmt":"2025-08-14T19:58:22","slug":"terovania-game-marketing-widgets-for-steam","status":"publish","type":"plugin","link":"https:\/\/cn.wordpress.org\/plugins\/terovania-game-marketing-widgets-for-steam\/","author":23339830,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.5","stable_tag":"1.0.5","tested":"6.8.5","requires":"6.0","requires_php":"7.4","requires_plugins":null,"header_name":"Terovania Game Marketing Widgets for Steam\u00ae","header_author":"Terovania Solutions","header_description":"Add a customizable Steam widget to your WordPress site. Includes GA4\/GTM event tracking, UTM parameter support, GDPR-friendly implementation, and branding options.","assets_banners_color":"dee3d2","last_updated":"2025-08-14 19:58:22","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/terovania.solutions\/wordpress-plugin\/steam-integration","header_author_uri":"https:\/\/terovania.solutions","rating":0,"author_block_rating":0,"active_installs":10,"downloads":380,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.5":{"tag":"1.0.5","author":"terovania","date":"2025-08-14 19:58:22"}},"upgrade_notice":{"1.0.5":"<p>Major UX update: native Toolbar controls (App ID, language search, visual toggles), extended language support with fallback, improved editor behavior, and Plugin Check compliance fixes. Recommended for all users.<\/p>"},"ratings":[],"assets_icons":{"icon-256x256.png":{"filename":"icon-256x256.png","revision":3342027,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256},"icon-512x512.png":{"filename":"icon-512x512.png","revision":3345289,"resolution":"512x512","location":"assets","locale":"","width":512,"height":512}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3345290,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3345289,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":{"terovania\/steam-widget":{"apiVersion":3,"name":"terovania\/steam-widget","title":"Steam\u00ae Integration Widget","category":"widgets","description":"Customizable Steam widget (server-rendered, GDPR-friendly) with UTM & GA4 tracking. Not affiliated with Valve\u00ae\/Steam\u00ae.","keywords":["steam","game","widget","marketing","wishlist"],"supports":{"html":false},"example":{"attributes":{"appId":"2477670","language":"en","showPrice":true,"showAgeRating":true,"showFeatureIcons":true,"showReleaseInfo":true,"ctaLabel":"Add to Steam Wishlist","branding":false}},"textdomain":"terovania-game-marketing-widgets-for-steam","editorScript":"tsi-block","style":"tsi-style","viewScript":"tsi-frontend","attributes":{"appId":{"type":"string","default":"2477670"},"language":{"type":"string","default":"de"},"utmSource":{"type":"string","default":"website"},"utmCampaign":{"type":"string","default":"steam-widget"},"ctaColor":{"type":"string","default":"#5c7e10"},"ctaHoverColor":{"type":"string","default":"#6d8f15"},"highlightColor":{"type":"string","default":"#a4d007"},"backgroundColor":{"type":"string","default":"#2a2a2a"},"ctaLabel":{"type":"string","default":"Add to Steam Wishlist"},"footnote":{"type":"string","default":"\u00b9"},"branding":{"type":"boolean","default":false},"showPrice":{"type":"boolean","default":true},"showAgeRating":{"type":"boolean","default":true},"showFeatureIcons":{"type":"boolean","default":true},"showReleaseInfo":{"type":"boolean","default":true}}}},"tagged_versions":["1.0.5"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3342081,"resolution":"1","location":"assets","locale":"","width":1920,"height":1080},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3342083,"resolution":"2","location":"assets","locale":"","width":1920,"height":1080},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3342085,"resolution":"3","location":"assets","locale":"","width":1920,"height":1080}},"screenshots":{"1":"Steam Widget block in Gutenberg editor with settings panel","2":"Frontend view of the Steam widget (default style)","3":"Color customization options in the block settings","4":"Example of GA4\/GTM tracking integration for wishlist clicks","5":"Fully responsive design on desktop and mobile"}},"plugin_section":[],"plugin_tags":[193472,456,5050,162,1666],"plugin_category":[43,55],"plugin_contributors":[246108],"plugin_business_model":[],"class_list":["post-244979","plugin","type-plugin","status-publish","hentry","plugin_tags-ga4","plugin_tags-marketing","plugin_tags-steam","plugin_tags-widget","plugin_tags-wishlist","plugin_category-customization","plugin_category-seo-and-marketing","plugin_contributors-terovania","plugin_committers-terovania"],"banners":{"banner":"https:\/\/ps.w.org\/terovania-game-marketing-widgets-for-steam\/assets\/banner-772x250.png?rev=3345289","banner_2x":"https:\/\/ps.w.org\/terovania-game-marketing-widgets-for-steam\/assets\/banner-1544x500.png?rev=3345290","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/terovania-game-marketing-widgets-for-steam\/assets\/icon-256x256.png?rev=3342027","icon_2x":"https:\/\/ps.w.org\/terovania-game-marketing-widgets-for-steam\/assets\/icon-256x256.png?rev=3342027","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/terovania-game-marketing-widgets-for-steam\/assets\/screenshot-1.png?rev=3342081","caption":"Steam Widget block in Gutenberg editor with settings panel"},{"src":"https:\/\/ps.w.org\/terovania-game-marketing-widgets-for-steam\/assets\/screenshot-2.png?rev=3342083","caption":"Frontend view of the Steam widget (default style)"},{"src":"https:\/\/ps.w.org\/terovania-game-marketing-widgets-for-steam\/assets\/screenshot-3.png?rev=3342085","caption":"Color customization options in the block settings"}],"raw_content":"<!--section=description-->\n<p><strong>The first completely trackable and GDPR-friendly Steam widget solution for WordPress!<\/strong>\nThis plugin allows you to integrate a responsive and customizable Steam game widget without using external iframes \u2013 fully hosted on your own site.<\/p>\n\n<p>Unlike the official Steam iframe widget, this plugin offers:\n- \u2705 <strong>Trackable wishlist button clicks<\/strong> (Google Tag Manager &amp; GA4 compatible)\n- \u2705 <strong>Custom UTM parameters<\/strong> for tracking your Steam page links\n- \u2705 <strong>Fully responsive layout<\/strong> optimized for mobile &amp; desktop\n- \u2705 <strong>GDPR-friendly<\/strong> (no iframes, external scripts, embedded content or cookies)<\/p>\n\n<p>Perfect for indie developers, publishers, and marketing teams who want <strong>analytics-ready game landing pages<\/strong> without breaking privacy rules.<\/p>\n\n<p><strong>Why choose this over the official Steam widget?<\/strong>\n- The official widget loads external content (iframe) \u2192 not GDPR-friendly\n- No easy event tracking \u2192 this plugin adds full GTM &amp; GA4 support\n- No UTM link control \u2192 this plugin enables custom campaign tracking<\/p>\n\n<p><strong>Plugin Highlights:<\/strong>\n- Dynamic Steam API integration (auto-loads game info by App ID)\n- Fully customizable design without coding\n- Gutenberg block with <strong>native Toolbar controls<\/strong> (easy drag &amp; drop):\n  - Set <strong>Steam App ID<\/strong> via Dropdown (with validation)\n  - <strong>Language chooser with search functionality<\/strong> (maps to Steam API languages)\n  - Toolbar <strong>toggles<\/strong>: Show Price \/ Age Rating \/ Feature Icons \/ Release Info\n- Inspector with <strong>help texts<\/strong> for all important fields (App ID, UTM, Footnote, CTA)\n- Steam data language:\n  - Uses the selected language for Steam content (description, price\/ratings)\n  - <strong>Automatic English fallback<\/strong> if a language has no localized text\n  - Note: UI labels follow the WordPress site language\n- Fully responsive layout, optimized for mobile &amp; desktop\n- <strong>GDPR-friendly<\/strong>: no Steam iframe, optional local image caching\n- <strong>UTM parameters<\/strong> for tracking your outbound Steam links in Steam analytics\n- <strong>Tracking<\/strong>: pushes <code>steamWidgetImpression<\/code> and <code>steamWishlistClick<\/code> to the dataLayer (GTM\/GA4-ready)<\/p>\n\n<p>\ud83d\udccc <strong>Note:<\/strong> Premium features coming soon (advanced color customization and additional layouts).<\/p>\n\n<h3>Disclaimer<\/h3>\n\n<p>This plugin is not affiliated with, endorsed, or sponsored by Valve Corporation.\n\"Steam\" and the Steam logo are trademarks or registered trademarks of Valve Corporation.\nAll rights reserved by their respective owners.<\/p>\n\n<h3>License<\/h3>\n\n<p>This plugin is licensed under the GPL v2 or later.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin folder to <code>\/wp-content\/plugins\/<\/code> or install directly via the WordPress Plugin Directory.<\/li>\n<li>Activate the plugin through the 'Plugins' menu in WordPress.<\/li>\n<li>Add the <strong>Steam Widget block<\/strong> in your Gutenberg editor.<\/li>\n<li>Enter your <strong>Steam App ID<\/strong> and adjust colors, UTM parameters, and optional credit in the block settings.<\/li>\n<li>(Optional) Configure your <strong>Google Tag Manager or GA4<\/strong> for wishlist click &amp; impression tracking.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id='does%20this%20plugin%20use%20the%20official%20steam%20widget%3F'><h3>Does this plugin use the official Steam widget?<\/h3><\/dt>\n<dd><p>No. This plugin uses the Steam Store API to retrieve game data and renders the widget on your server for GDPR compliance.<\/p><\/dd>\n<dt id='is%20this%20plugin%20gdpr-friendly%3F'><h3>Is this plugin GDPR-friendly?<\/h3><\/dt>\n<dd><p>Yes. Unlike the official Steam iframe widget, this plugin does not load external resources from Valve and does not set cookies.<\/p><\/dd>\n<dt id='can%20i%20track%20widget%20impressions%20and%20clicks%3F'><h3>Can I track widget impressions and clicks?<\/h3><\/dt>\n<dd><p>Yes! The plugin pushes <strong>dataLayer events<\/strong> for:\n- <code>steamWidgetImpression<\/code> (when the widget enters the viewport)\n- <code>steamWishlistClick<\/code> (when the wishlist button is clicked)\nThese can be integrated into GA4 or Google Tag Manager.<\/p><\/dd>\n<dt id='can%20i%20customize%20the%20widget%20design%3F'><h3>Can I customize the widget design?<\/h3><\/dt>\n<dd><p>Yes. You can adjust colors and branding in the Gutenberg block inspector. Premium features (coming soon) will allow more flexibility.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.5<\/h4>\n\n<ul>\n<li>New: Native <strong>Toolbar Dropdown<\/strong> to edit the Steam <strong>App ID<\/strong> (replaces browser prompt) with validation<\/li>\n<li>New: <strong>Language search dropdown<\/strong> in the Toolbar; extended language mapping to Steam API (e.g. <em>koreana, schinese, tchinese, latam, brazilian<\/em>, \u2026)<\/li>\n<li>New: <strong>Toolbar toggles<\/strong> for Show Price, Show Age Rating, Show Feature Icons, Show Release Status &amp; Date<\/li>\n<li>New: <strong>Inspector help texts<\/strong> for App ID, UTM Source, UTM Campaign, Footnote Symbol, Custom CTA Label<\/li>\n<li>New: <strong>English fallback<\/strong> for Steam descriptions when no localized text is available (editor shows a hint)<\/li>\n<li>Change: Moved to <code>block.json<\/code> registration; cleaned editor wrapper to fix selection\/highlight issues<\/li>\n<li>Change: Reworked editor interactions (pointer-events\/overlay) for reliable block selection<\/li>\n<li>Improvement: Output escaping for wrapper markup to satisfy <strong>WP Plugin Check<\/strong><\/li>\n<li>Improvement: Minor UI wording &amp; accessibility tweaks<\/li>\n<li>Tested up to WordPress <strong>6.8<\/strong><\/li>\n<\/ul>\n\n<h4>1.0.4<\/h4>\n\n<ul>\n<li>Added local image caching for GDPR compliance<\/li>\n<li>Improved error handling for Steam API requests<\/li>\n<li>Code cleanup and WP Plugin Check compliance<\/li>\n<\/ul>\n\n<h4>1.0.3<\/h4>\n\n<ul>\n<li>Added UTM parameter support for Steam links<\/li>\n<li>Implemented hover color customization<\/li>\n<li>Added impression tracking via Intersection Observer<\/li>\n<li>Improved Inspector UI for Gutenberg block<\/li>\n<li>Added text domain and .pot file for localization<\/li>\n<\/ul>\n\n<h4>1.0.2<\/h4>\n\n<ul>\n<li>Fixed hover state issues for CTA button<\/li>\n<li>Added branding toggle and premium feature placeholders<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Initial release with Gutenberg block, Steam API integration, and wishlist button tracking.<\/li>\n<\/ul>","raw_excerpt":"Add a customizable Steam widget to your WordPress site with GA4-ready tracking features, UTM tracking, and GDPR-friendly implementation.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/244979","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=244979"}],"author":[{"embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/terovania"}],"wp:attachment":[{"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=244979"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=244979"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=244979"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=244979"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=244979"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=244979"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}