This section of the documentation will explore some of the run time configuration options available during and once the site has been deployed.
Typically the default output for property prices is a good fit for most agents though from time to time, agents, especially those in London, may prefer to to list rental prices as per week.
There are two content blocks (found in agent admin at /configure/website/content/content/list), ‘Lettings price text’ and ‘Sales price text’, which allow the output of a property.price call to be changed on the fly.
The default output of a rental property will be in the form of ‘£1500pcm’, to alter this we can insert some liquid into those content blocks.
£{{property.price_value | pcm_to_pcw | number_with_delimiter}}pw | £{{ property.price_value| number_with_delimiter}}pcmFor rental properties property.price_value will always output a pcm price.
The filter pcm_to_pcw will perform a pcw conversion.
number_with_delimeter will humanise the output, converting 1500 to 1,500.
Using a combination of these filters it should be possible to customise the pice output to your client’s liking.
As we’ve touched upon in other parts of the documentation, the config.yml file can be looked on as a central configuration repository for your theme. There are a number of options that you can add that will effect the way your theme works. YAML files are sensitive to spaces and tabbing and have a tree like format in regard to sections, keys and values. If you add some new values and get an error straight after, you may have formatted it incorrectly.
Below is a growing list of options you can use:
Purpose: the name of your theme
Purpose: caching
Purpose: the type of theme (normally added for you)
Purpose: a container of global options that can include:
Purpose: enables national searching
Purpose: total count of properties in a result set made available (now enabled by default)
Purpose:
Purpose: enables national searching
Purpose:
Purpose: a collection of controller/action sidebars to render
Purpose: declaration of sidebar
Purpose: chunks defined here will show up in the agent’s CMS admin as available them chunks
Purpose: name of the chunk
Purpose: role of the chunk
Purpose: assign categories to pages for general purposes
Purpose: container for JS and CSS asset packs
Purpose: container for JS asset packs
Purpose: a record for one JS file to minify
Purpose: container for CSS asset packs
Purpose: a record for one CSS file to minify (add .css extension for none LCSS files)
Here’s a sample theme YAML file:
theme:
name: "Hatch"
cache_for: 5
type: "agency_theme"
enabled:
- "national_search"
- 'include_count_on_global_listings'
sidebars:
'branches#show' : 'branch_show_sidebar'
'branches#index' : 'branch_show_sidebar'
'branches#properties' : 'property_search_sidebar'
'properties#index' : 'property_search_sidebar'
'locations#show' : 'property_search_sidebar'
'staff#show' : 'staff_show_sidebar'
'home#home' : 'home_home_sidebar'
'users#new' : 'users_new_sidebar'
site_content_chunks:
- name: 'sales_channel_sidebar_ad_unit'
description: 'The ad unit for your sales sidebar section'
- name: 'branches_list'
description: 'top branches list'
category_assignments:
'pages#request_valuation' : 'about'
asset_packs:
javascript:
- respond
- vendor/jquery.mobile.custom.min
- vendor/bxslider/jquery.bxslider.min
- vendor/jquery.scrollTo.min
- vendor/jquery.tooltipster.min
stylesheet:
- normalize.min.css
- dropkick.css
- main.lcss
- tooltipster.css
- leafletOn form submissions, successful or other, the browser will display a modal pop-up with a default message. The content is customisable, using the following example as a model:
<script>
$(document).ready(function(){
Ctesius.addConfig('name-of-the-flash-message-to-override', 'your_custom_message');
});
</script>This should typically be added to your ‘js_event_registers.liquid’ file, although they can be added to a specific page where needed.
If your theme is not bespoke, then ‘your_custom_message’ should be replaced with a content block so that future users of the theme can add custom content.
Another example:
<script>
$(document).ready(function(){
Ctesius.addConfig('flash-message-welcome-lead-sent', 'Thank you for applying for the {{ article.slug | remove: "current-opportunities-"" }}' +
' position. You will have received a confirmation of your application and will hear from us if successful.' );
});
</script>This would output:
Thank you for applying for the generic office position. You will have received a
confirmation of your application and will hear from us if successful.Here is a list of flash message types, and the default messages which can be overriden: