[ckan-dev] Template modification: where to add secondary content block?
John Brisbin
john at boab.info
Sun Jun 8 23:50:55 UTC 2014
Hey thanks heaps Vitor!
As noted I'm very much confused and just getting started. It did not
occur to me that these sorts of template changes constitute a change to
Theming, but now I can see that's the paradigm that CKAN uses. You've
saved me hours of frustration, thanks!
Cheers,
JB
On 9/06/2014 6:34 AM, Vitor Baptista wrote:
> Hi John,
>
> Please refer to the Theming Guide at
> http://docs.ckan.org/en/latest/theming/index.html . The recommended
> way of customizing a theme is to create a new extension and change
> anything you'd like there, so you don't change CKAN core files, which
> will save you lots of headaches down the road, when you want to
> upgrade CKAN. This "project" that the spatial docs talk about is your
> custom extension.
>
> You can see a few examples of extensions customizing the themes at
> https://github.com/okfn/ckanext-mx and
> https://github.com/okfn/ckanext-pakistan .
>
> The specific docs on how to customize a block is in
> http://docs.ckan.org/en/latest/theming/templates.html#replacing-template-blocks-with-block
>
> Cheers,
>
>
> 2014-06-08 10:58 GMT-03:00 John Brisbin <john at boab.info
> <mailto:john at boab.info>>:
>
> G'Day all,
>
> We're very new to CKAN and the templating system, so apologies in
> advance for the obvious.
>
> Following the documentation at:
>
> http://docs.ckan.org/projects/ckanext-spatial/en/latest/spatial-search.html
>
> We get to the stage of adding the spatial search widget.
>
> First problem is making sure we have the right path to the
> templates. Ours is a build from source install and I don't have
> the concept of "projects". So this advice is mysterious:
>
> ----
> To add the map widget to the to the sidebar of the search page,
> add this to the dataset search page template
> (myproj/ckanext/myproj/templates/package/search.html)
> ----
>
> Fishing around a bit I see the search.html template at:
>
> /usr/lib/ckan/default/src/ckan/ckan/templates/package/search.html
>
> This should be the right file to modify? Assuming yes...
>
> Next problem is to add the block given in the documentation. Where
> does this go?
>
> I see the template already has a % block secondary_content %
> declaration, so I should just be able to add the spatial fragment
> into the existing contents.
>
> But I get an error:
>
> ----
> Template spatial/snippets/spatial_query.html cannot be found
> ----
>
> This makes me think that maybe I'm not in the right template area,
> or have somehow not got the extension installed quite right. I
> tried manually shoving the spatial snippets into the same
> directory as search.html, changed the path in the block include
> statement, and still got a "can't find the snippet" error.
>
> Is this making enough sense to provide any guidance?
>
> Thanks indeed,
>
> JB
>
> --
> John Brisbin
> Managing Director, BoaB interactive Pty Ltd
> POB 248, MT Molloy QLD 4871
>
> E: john at boab.info <mailto:john at boab.info>
> M: 0407 471 565 | P: 07 4094 2172
> Skype: boabjohn | Twitter: @boabjohn
>
> _______________________________________________
> ckan-dev mailing list
> ckan-dev at lists.okfn.org <mailto:ckan-dev at lists.okfn.org>
> https://lists.okfn.org/mailman/listinfo/ckan-dev
> Unsubscribe: https://lists.okfn.org/mailman/options/ckan-dev
>
>
>
>
> --
>
> Vítor Baptista
>
> Developer |http://vitorbaptista.com | LinkedIn
> <http://www.linkedin.com/in/vitorbaptista> | @vitorbaptista
> <http://twitter.com/vitorbaptista>
>
> The Open Knowledge Foundation <http://okfn.org>
>
> /Empowering through Open Knowledge/
>
> http://okfn.org/ | @okfn <http://twitter.com/okfn> | OKF on Facebook
> <https://www.facebook.com/OKFNetwork> | Blog <http://blog.okfn.org/>
> | Newsletter <http://okfn.org/about/newsletter/>
>
--
John Brisbin
Managing Director, BoaB interactive Pty Ltd
POB 248, MT Molloy QLD 4871
E: john at boab.info
M: 0407 471 565 | P: 07 4094 2172
Skype: boabjohn | Twitter: @boabjohn
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.okfn.org/pipermail/ckan-dev/attachments/20140609/997f1241/attachment-0003.html>
More information about the ckan-dev
mailing list