Contact details have a habit of appearing on a dozen pages. When the phone number or email changes, you get to find every one of them - a real pain!<\/p>\n\n
Primo Vars fixes that. Define a value once on a single settings screen, give it a name, and use its shortcode wherever you need it. Change the value and every page follows.<\/p>\n\n
Each variable has a type<\/strong>, and the type does the fiddly work for you:<\/p>\n\n In a theme template:<\/p>\n\n Insert the Primo Var<\/strong> block, pick a variable from the dropdown, and it\nrenders exactly what the shortcode would. Use the shortcode when you want a\nvalue inline in a sentence, and the block when it stands on its own.<\/p>\n\n A fresh install creates seven empty variables to fill in: phone, email,\naddress, facebook, instagram, linkedin and youtube. Delete the ones you do not\nwant, or add your own. A YouTube channel is just a Link, the same as any other\nsocial profile.<\/p>\n\n Filter The HTML handed to the filter is already escaped. Anything your callback adds\nis yours to escape.<\/p>\n\n Real phone numbers are messy. Where the number cannot be worked out automatically, no link is shown rather than a wrong one. That covers vanity numbers like Nothing renders. Visitors never see a placeholder or an error message.<\/p><\/dd>\n A link needs its scheme, so use Yes. Widget areas have been block-based since WordPress 5.8, so add the Primo\nVar block, or a Shortcode block holding Navigation menu labels are the exception: WordPress does not run shortcodes\nthere, and this plugin deliberately does not add a filter to make it, because\nbroad No. No external requests, no tracking.<\/p><\/dd>\n\n<\/dl>\n\n\n\n
tel:<\/code> link, while displaying the number exactly as you typed it, brackets, spaces, country code and all.<\/li>\nmailto:<\/code> link with the address obfuscated against scrapers.<\/li>\nUsage<\/h4>\n\n
[primo_var key=\"phone\"]\n[primo_var key=\"email\"]\n[primo_var key=\"facebook\" text=\"Follow us\"]\n[primo_var key=\"phone\" raw=\"1\"]\n\nraw=\"1\" returns the plain value with no link, for when you are building your own markup around it.\n<\/code><\/pre>\n\n<?php echo primo_vars_get( 'phone' ); ?>\n<?php echo primo_vars_get( 'phone', true ); \/\/ raw ?>\n<\/code><\/pre>\n\nIn the block editor<\/h4>\n\n
Starter variables<\/h4>\n\n
For developers<\/h4>\n\n
primo_vars_output<\/code> to change what any variable renders, from the\nshortcode, the block and primo_vars_get()<\/code> alike. It fires for a variable\nthat is defined but left empty, which is what the example below relies on;\nit does not fire for a key that is not defined at all, since all three entry\npoints return an empty string before reaching this filter in that case.<\/p>\n\nadd_filter( 'primo_vars_output', function ( $html, $var, $atts ) {\n if ( '' === $html && 'phone' === $var['type'] ) {\n return 'Call the office';\n }\n return $html;\n}, 10, 3 );\n<\/code><\/pre>\n\nPhone numbers with extra text<\/h4>\n\n
+61 491 570 156 Option 2<\/code> and (08) 8123 1234<\/code> both display exactly as typed, and both produce a correct dial link. The trailing \"Option 2\" is not dialled.<\/p>\n\n1300 PRIMO<\/code>, and two numbers written in one field such as (08) 8123 1234 (0412 345 678)<\/code>. Fill in the optional Dial as<\/strong> field on that row and it will link exactly as you specify.<\/p>\n\n\n\n
\/wp-content\/plugins\/<\/code> and activate it.<\/li>\n\n
What happens if I use a shortcode for a variable I have not filled in?<\/h3><\/dt>\n
Why was my web address rejected?<\/h3><\/dt>\n
https:\/\/facebook.com\/you<\/code> rather than facebook.com\/you<\/code>. The plugin tells you which variable it refused and leaves the old value in place rather than saving something that would not work.<\/p><\/dd>\nDoes this work in widgets?<\/h3><\/dt>\n
[primo_var]<\/code>, to any widget area or\nsite editor template.<\/p>\n\ndo_shortcode()<\/code> filters widen the injection surface for everyone.<\/p><\/dd>\nDoes it phone home?<\/h3><\/dt>\n
1.0.0<\/h4>\n\n
\n