Visto che non ho trovato molta documentazione lascio qui un piccolo esempio pratico di come utilizzare un template custom per una form costruita con z3c.form.

Immaginiamo ad esempio di voler creare un semplice form di ricerca:

Partiamo dalla nostra form con z3c.form:

class ISearchForm(Interface):

    search = schema.TextLine(
             title = _(u"Search"),
             required = True,
             description =u'',
             )

class SearchForm(form.Form):
    fields = field.Fields(ISearchForm)
    ignoreContext = True

    @button.buttonAndHandler(_(u'Search'))
    def handleApply(self, action):
        data, errors = self.extractData()
        if errors:
            self.status = _("Error")
            return
        self.results = data

Se non volessimo utilizzare un template custom potremo visualizzare la nostra form usando:

from plone.z3cform.layout import wrap_form 
SearchFormView = wrap_form(SearchForm)

Poi registriamo la nostra vista nel configure.zcml:

   <browser:page
      for="*"
      name="search_form"
      class=".searchform.SearchFormView"
      permission="zope2.View"
    />

In questo caso la mia vista è indipendente da contesto e quindi ho specificato for="*". Nel caso voglia invece utilizzare un template custom dovrò fare:

from plone.z3cform.layout import FormWrapper

class SearchFormView(FormWrapper):

    index = ViewPageTemplateFile('custom_search_form.pt')
    form = esgraphfolderForm
    
    def getData(self):
        ....
        #self.form_instance è l'istanza della form e quindi dentro
        #self.form_instance.results trovo i dati della form già validati
        ....
        return data

Visto che la registrazione sul zcml non cambia, l'unica cosa che manca è la vista custom ('custom_search_form.pt'):

....
<div id="skel-contents">
     <span tal:replace="structure view/contents" />
</div>
...
<div tal:repeat="result view/getData"></div>
....

Nel page template, view farà riferimento alla browserview che fa da wrapper alla form. Dentro contents ci saranno i widgets.

Spero che sia utile ... buon lavoro !