Custom Labels for Form Fields & Buttons

Labels for booking form fields and buttons are pre-defined in CabGrid Pro so that they can be mapped to translations. It is rare that these labels would need to be changed, but in some circumstances it may be necessary – for example, in re-purposing CabGrid for a distinct use, other than taxi journeys.

With this in mind, CabGrid Pro v4.2+ provides the means to update field labels & buttons displayed in the price calculator interface. However, this is an advanced feature and therefore it is not part of the main admin interface. Rather, it must be done by editing one of the plugin’s PHP files: _settings.php

This has the drawback that updating the plugin will overwrite any changes made manually. It is recommended to keep a backup of the file or its contents so it can be restored when an update is applied. From CabGrid Pro v4.5.9 this can be overcome using a separate “Defaults” plugin (details below).

How to edit buttons & field labels using WordPress

Note: You must have file editing enabled to achieve this (see https://codex.wordpress.org/Hardening_WordPress#Disable_File_Editing )

1. Log in to WordPress Admin
2. From the admin menu, click Plugins
3. Under CabGrid Pro, click Deactivate
4. From the admin menu, under Plugins, click Editor
5. At the top right of the Edit Plugins page, choose CabGrid Pro from the ‘Select plugin to edit‘ drop-down box and click the Select button
6. From the Plugin Files panel, click _settings.php. This loads the contents of _settings.php in the editor pane.
7. Make the required adjustments in the editor pane
   Enter new values for each of the variables between the quotes. For example:
   $cabGridProButtonLabelBook="Reserve";
8. Beneath the editor pane, click Update File
9. From the admin menu, click Plugins
10. Under CabGrid Pro, click Activate

(Also see this video…)
When editing the file, comments (prefixed with two slashes: // ) show the default (original) text for the field in question and where it is used (or it’s purpose) within CabGrid.

Adding CabGrid labels to a separate plugin file – Free ‘Defaults’ Add-on Plugin

As mentioned above, the _settings.php file will be overwritten each time the CabGrid Pro plugin is updated. Any customisations made in the _settings.php file would then be lost and require restoring from a backup. To get around this, an add-on plugin can be used to specify custom labels and values. This extra plugin would not be updated with the main plugin, thus preserving customisations.

We have created a template for this add-on plugin. To use it, it should be downloaded, edited locally, and then uploaded to the WordPress plugins folder.

For more info, please see: Advanced settings with the free Defaults Add-on plugin.