{"id":374078,"date":"2026-10-08T23:22:13","date_gmt":"2026-10-08T23:22:13","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/scale-ring-size\/"},"modified":"2026-10-09T14:10:34","modified_gmt":"2026-10-09T14:10:34","slug":"ws-scale-ring-size","status":"publish","type":"plugin","link":"https:\/\/fa.wordpress.org\/plugins\/ws-scale-ring-size\/","author":14193711,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.0","stable_tag":"1.0.0","tested":"7.1.3","requires":"6.1","requires_php":"7.4","requires_plugins":null,"header_name":"WS Scale Ring Size","header_author":"tafreshi.art","header_description":"A self-calibrating on-screen ring sizer. It reads the screen size and pixel density from the device, draws the circle at its true physical size, and lets visitors measure with a ring or a piece of thread. Ships Gutenberg, Elementor and WPBakery elements plus product-aware JSON-LD schema.","assets_banners_color":"d0c2ee","last_updated":"2026-10-09 14:10:34","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/tafreshi.art\/scale-ring-size\/","header_plugin_uri":"https:\/\/tafreshi.art\/scale-ring-size\/","header_author_uri":"https:\/\/tafreshi.art","rating":0,"author_block_rating":0,"active_installs":0,"downloads":105,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"hassantafreshi","date":"2026-10-09 14:10:34","revision":3736830}},"upgrade_notice":{"1.0.0":"<p>First release.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3735663,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3735663,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3735663,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3735663,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":{"ws-scale-ring-size\/ring-sizer":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":3,"name":"ws-scale-ring-size\/ring-sizer","title":"Ring Sizer","category":"ws-scale-ring-size","icon":"marker","description":"A self-calibrating on-screen ring size finder. It sizes itself to the visitor's screen, then measures with a ring or a piece of thread.","keywords":["ring","size","sizer","jewelry","jewellery","measure"],"textdomain":"ws-scale-ring-size","supports":{"html":false,"align":["wide","full"],"spacing":{"margin":true,"padding":false},"anchor":true},"attributes":{"layout":{"type":"string","default":""},"methods":{"type":"string","default":""},"showIntro":{"type":"string","default":""},"showResult":{"type":"string","default":""},"showTable":{"type":"string","default":""},"showTips":{"type":"string","default":""},"showFaq":{"type":"string","default":""},"title":{"type":"string","default":""},"subtitle":{"type":"string","default":""},"ctaText":{"type":"string","default":""},"ctaUrl":{"type":"string","default":""},"primary":{"type":"string","default":""},"align":{"type":"string"}},"editorScript":"file:.\/index.js","editorStyle":"file:.\/editor.css","style":"srsz-front","viewScript":"srsz-front"}},"tagged_versions":["1.0.0"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"The guided flow, with the screen detected automatically.","2":"Measuring with a ring on the screen.","3":"The result step with size conversions.","4":"The settings screen with its live preview."}},"plugin_section":[],"plugin_tags":[237298,285185,285186,171945,286],"plugin_category":[45],"plugin_contributors":[196499],"plugin_business_model":[],"class_list":["post-374078","plugin","type-plugin","status-publish","hentry","plugin_tags-jewelry","plugin_tags-ring-size","plugin_tags-ring-sizer","plugin_tags-size-guide","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-hassantafreshi","plugin_committers-hassantafreshi"],"banners":{"banner":"https:\/\/ps.w.org\/ws-scale-ring-size\/assets\/banner-772x250.png?rev=3735663","banner_2x":"https:\/\/ps.w.org\/ws-scale-ring-size\/assets\/banner-1544x500.png?rev=3735663","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/ws-scale-ring-size\/assets\/icon-128x128.png?rev=3735663","icon_2x":"https:\/\/ps.w.org\/ws-scale-ring-size\/assets\/icon-256x256.png?rev=3735663","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>WS Scale Ring Size adds an on-screen ring sizer to any page, post or product. The visitor lays a ring they already own on the screen, shrinks the circle to the inside edge of the band, and reads their size. There is nothing to set up and nothing for them to calibrate.<\/p>\n\n<p><strong>Why on-screen sizers are usually wrong, and how this one is not<\/strong><\/p>\n\n<p>Most of them assume one CSS pixel equals 1\/96 inch. That is only true on a classic desktop monitor. On a phone the viewport is scaled for reading distance, so the same circle renders about 40% smaller than intended \u2014 enough to be several sizes out.<\/p>\n\n<p>WS Scale Ring Size instead reads what the browser really does report: the size of the screen in CSS pixels and the device pixel ratio. Together those identify the handset, and a built-in profile table turns that into the panel's pixels per inch. From there:<\/p>\n\n<pre><code>pixels per mm = pixels per inch \/ 25.4 \/ device pixel ratio\n<\/code><\/pre>\n\n<p>Known devices are exact. Anything else is derived from the screen resolution against a typical diagonal for that class of device, which is usually within a few per cent. Browser zoom is folded into the device pixel ratio and cancels straight back out of that formula, and pinch zoom is corrected separately, so the circle stays true \u2014 the visitor is still told when they are not at 100%, because a zoomed page can crop it.<\/p>\n\n<p><strong>Features<\/strong><\/p>\n\n<ul>\n<li>Gutenberg block, Elementor widget, WPBakery element and a shortcode \u2014 all driven by the same settings.<\/li>\n<li>No calibration step, no card, no ruler. The sizer configures itself from the device.<\/li>\n<li>Two measuring methods: place a ring on the screen, or measure the finger with thread and type the millimetres.<\/li>\n<li>Choose between a guided multi-step flow and a compact measuring-only widget for product pages.<\/li>\n<li>Decide what happens on an unrecognised device: show the circle from an estimate, or offer the thread method only.<\/li>\n<li>Full design control from one settings screen: colours, ring outline thickness, board style, radius, spacing, font sizes and line height, with a live preview.<\/li>\n<li>Size systems: ISO\/EU (also used in Iran), US, UK, Japan and Switzerland \u2014 pick the primary one and any number of secondary ones.<\/li>\n<li>Latin, Persian or Arabic-Indic digits, following the site language by default.<\/li>\n<li>Structured data that adapts to the page. On a WooCommerce product the tool and its questions attach to the Product your store already publishes; on a guide page it is described in its own right as a WebApplication with a HowTo and an FAQ.<\/li>\n<li>Optional credit line linking back to the plugin.<\/li>\n<li>Right-to-left ready; the stylesheet uses logical properties throughout.<\/li>\n<li>No tracking, no external requests, no cookies, no browser storage. Everything happens in the page.<\/li>\n<\/ul>\n\n<p><strong>Adding your own device<\/strong><\/p>\n\n<p>Densities come from a filterable table, so an unusual handset can be pinned down exactly:<\/p>\n\n<pre><code>add_filter( 'srsz_device_profiles', function ( $p ) { $p['generic']['360x772@3'] = 409; return $p; } );\n<\/code><\/pre>\n\n<p>The key is the CSS portrait viewport and the device pixel ratio; the value is the panel density in pixels per inch.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the <code>ws-scale-ring-size<\/code> folder to <code>\/wp-content\/plugins\/<\/code>, or install the ZIP from <strong>Plugins \u2192 Add New \u2192 Upload Plugin<\/strong>.<\/li>\n<li>Activate the plugin.<\/li>\n<li>Open <strong>Tools \u2192 Ring Sizer<\/strong> to set colours, steps and size systems.<\/li>\n<li>Add the <strong>Ring Sizer<\/strong> block, the Elementor or WPBakery element, or the <code>[ws_scale_ring_size]<\/code> shortcode to a page.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"do%20visitors%20have%20to%20calibrate%20anything%3F\"><h3>Do visitors have to calibrate anything?<\/h3><\/dt>\n<dd><p>No. The sizer works out the screen density from what the browser reports about the device, so there is no setup step at all.<\/p><\/dd>\n<dt id=\"what%20happens%20on%20a%20device%20you%20do%20not%20recognise%3F\"><h3>What happens on a device you do not recognise?<\/h3><\/dt>\n<dd><p>The density is worked out from the screen resolution instead, which is usually within a few per cent. Under <strong>Tools \u2192 Ring Sizer \u2192 Flow &amp; steps<\/strong> you can choose to hide the circle on those devices and offer the thread method only.<\/p><\/dd>\n<dt id=\"does%20browser%20zoom%20break%20it%3F\"><h3>Does browser zoom break it?<\/h3><\/dt>\n<dd><p>Desktop page zoom is folded into the device pixel ratio, so it cancels out of the calculation. Pinch zoom on a phone is corrected separately. The visitor is still warned when they are not at 100%, because a zoomed page can crop the circle.<\/p><\/dd>\n<dt id=\"does%20it%20work%20in%20persian%20or%20arabic%3F\"><h3>Does it work in Persian or Arabic?<\/h3><\/dt>\n<dd><p>Yes. The layout is right-to-left aware and digits can be rendered as Persian or Arabic-Indic numerals, automatically or by choice.<\/p><\/dd>\n<dt id=\"does%20it%20need%20woocommerce%3F\"><h3>Does it need WooCommerce?<\/h3><\/dt>\n<dd><p>No. WooCommerce is optional; when it is active the JSON-LD picks up the store currency.<\/p><\/dd>\n<dt id=\"can%20each%20page%20look%20different%3F\"><h3>Can each page look different?<\/h3><\/dt>\n<dd><p>Yes. The block, the Elementor widget and the WPBakery element can each override the steps, the wording, the call-to-action and the accent colour.<\/p><\/dd>\n<dt id=\"will%20the%20schema%20clash%20with%20my%20seo%20plugin%3F\"><h3>Will the schema clash with my SEO plugin?<\/h3><\/dt>\n<dd><p>On a product page the sizer references the Product node your store already publishes rather than emitting its own, and the questions are attached to that item instead of declaring the page an FAQPage. If your SEO plugin already outputs an FAQ block, turn the FAQ off under <strong>Tools \u2192 Ring Sizer \u2192 Schema<\/strong>.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>First release.<\/li>\n<\/ul>","raw_excerpt":"A ring size finder that sizes itself to the visitor's screen, so the circle it draws is a real millimetre measurement.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/374078","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=374078"}],"author":[{"embeddable":true,"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/hassantafreshi"}],"wp:attachment":[{"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=374078"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=374078"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=374078"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=374078"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=374078"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=374078"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}