Perch Template filter for converting Telephone Numbers

tonyastley · Jun 4th 2021

Hello,

I frequently need to convert a telephone number to a <href="tel:..." friendly format.

Currently I do this in php on every single page that requires it eg:

Code

//Telephone Number
$telNo = perch_content_custom('Contact Details', array('page' => '/contact.php', 'template' => '_contact_details/tel_only.html'), true);
// Strip out all characters apart from numbers
$telNoFormatted = preg_replace('/[^0-9]+/', '', $telNo);
// Remove the 2 digit international code (+44)
if (substr($telNoFormatted, 0, 2) == '44') {
$telNoFormatted = substr($telNoFormatted, 2);
}
// Remove the 4 digit international code (0044)
if (substr($telNoFormatted, 0, 4) == '0044') {
$telNoFormatted = substr($telNoFormatted, 4);
}
// Remove the initial Zero from the number
// Some people write it in international numbers like this: +44 (0)1234 567 890
// But it shouldn't be entered when dialling
if (substr($telNoFormatted, 0, 1) == '0') {
$telNoFormatted = substr($telNoFormatted, 1);
}
// Add the international prefix
$telNoFormatted = '+44' . $telNoFormatted;
PerchSystem::set_var('telNoFormatted', $telNoFormatted);

Display More

Does anyone know how I could do this using a perch template filter? To enable something like:

Code

<perch:content type="text" id="tel" filter="formatted"/>

PHP isn't my strong point, so whilst I don't necessarily need a finished filter as the answer (but feel free) a basic example to get me going would be great.

tonyastley · Jun 4th 2021

I think I've worked it out - this goes in the /perch/addons/templates/filters.php file:

PHP

<?php
class PerchTemplateFilter_formattedNo extends PerchTemplateFilter
{
public function filterAfterProcessing($telNo, $valueIsMarkup = false)
{
//Telephone Number
$telNoFormatted = preg_replace('/[^0-9]+/', '', $telNo);
// Remove the 2 digit international code (+44)
if (substr($telNoFormatted, 0, 2) == '44') {
$telNoFormatted = substr($telNoFormatted, 2);
}
// Remove the 4 digit international code (0044)
if (substr($telNoFormatted, 0, 4) == '0044') {
$telNoFormatted = substr($telNoFormatted, 4);
}
// Remove the initial Zero from the number
// Some people write it in international numbers like this: +44 (0)1234 567 890
// But it shouldn't be entered when dialling
if (substr($telNoFormatted, 0, 1) == '0') {
$telNoFormatted = substr($telNoFormatted, 1);
}
// Add the international prefix
$telNoFormatted = '+44' . $telNoFormatted;
return($telNoFormatted);
}
}
PerchSystem::register_template_filter('formattedNo', 'PerchTemplateFilter_formattedNo');
?>

Display More

The tag then looks like:

Code

<perch:content type="text" id="tel" filter="formattedNo"/>

Typical use case:

Code

Tel: <a href="tel:<perch:content type="text" id="tel" filter="formattedNo"/>" title="Call us on <perch:content type="text" id="tel" />"><perch:content type="text" id="tel" /></a>

Clive Walker · Jun 4th 2021

There's a template filter here https://grabapipit.com/pipits/template-filters/phone