[James Wee]

Dear Steven,

I realized that most of us who have bought a premium template and want to make minor changes are editing the core cmap template files in plugin/cmap/

1. What happens during the next cMap template update? Will it delete the old (edited) one and replace with the new one?

2. Will the custom template support all the features (shortcodes) in the activated template? In my case, the activated template is cMap.

[Steven Zahm]

@ James

1. Yes, any changes you made would have to be done again. The latest template API for Connection is pretty robust but it does need a little more flexibility for tweakers. I plan on doing that, hopefully for the .8 or .9 release. The idea will be you will be able to dupe the part of the template and drop it in an update safe location and that location will override the core file / callback. Now that doesn’t mean the override won’t break; that’ll depend on what you changed but if it’s minor tweak it should be fine. Another downside is if a bug or a new feature was implemented in the file you overrode you will get that feature. Honestly though, I think it would break first. That would really depend on the feature.

2. No, Custom templates will only have the features you program in them. There is no inheritance. Unless, of course, you base your custom template on a template which already includes said features.

Hope that makes sense!

[James Wee]

Makes perfect sense.

In fact, I have already edited the cmap file in such a way that it displays the way I want.

However, I would like to translate the cmap plugin as a template. But that isn’t possible because in connections_templates, the content of the template must have template.php, that is not available in the cmap plugin.

Plus, I need to translate
card.php
card-single.php
cmap.min.css
cmap.min.js
cmap.php
as a template file in connections_templates

How can I do that?

[Steven Zahm]

@ James

You can not move cMap into the connections_template folder that is currently there only to support legacy templates.

What do you want to translate in the template? All the strings can be set via shortcode options. See this FAQ for more details.

Here’s the complete list of str_***** options available to cMap.

str_select='Select Category'
str_select_all='Show All Categories'
str_image='No Logo Available'
str_tray_image='No Photo Available'
str_map_show='Show Map'
str_map_hide='Close Map'
str_bio_head='Biography'
str_bio_show='Show Bio'
str_bio_hide='Close Bio'
str_note_head='Notes'
str_note_show='Show Notes'
str_note_hide='Close Notes'
str_contact='Contact'
str_home_addr='Home'
str_work_addr='Work'
str_school_addr='School'
str_other_addr='Other'
str_home_phone='Home Phone'
str_home_fax='Home Fax'
str_cell_phone='Cell Phone'
str_work_phone='Work Phone'
str_work_fax='Work Fax'
str_personal_email='Personal Email'
str_work_email='Work Email'

[James Wee]

Oh that is not what i meant, what I meant was if I were to re-create a similar template to cmap in connections_templates. What should I do to enable all the functionality?

[Steven Zahm]

@ James

Dupe the folder giving it a new name. Give these files a new name:

cmap.min.css
cmap.min.js
cmap.php

Open the cmap.php and change every reference to cmap to something else. Make sure the reference to the css/js file names match whatever you renamed the files as.

After you’ve done that, you should be able to safely Active the plugin and it should show up as template option on the Connections : Templates admin page.

[Author]

Posts