New Feature: Plugins to Customize Your Smily Website

Great news for code enthusiasts! You can now take control of certain sections of your website with the new Plugins feature.

What are Plugins?

Plugins allow you to add and modify Liquid, HTML, CSS, and JavaScript code directly on your Smily website. This feature is ideal for users who want to customize their site in an advanced way.

Rest assured: if you're not a code expert, our team continues to perform the standard modifications included for you! This feature is designed for those who prefer to get their hands dirty with code themselves for more advanced customizations.

Availability and prerequisites

• Required version: Theme v3 Premium
• Not compatible with Theme v2 and Theme v1
• The list of available plugins may vary depending on your theme version
• If your site uses an earlier version of Theme v3, contact the Experience team to update to the latest version

How do Plugins work?

Plugins are integrated via the Plugins interface from the Website application in your Smily account. Each code snippet is saved per site and displays at the locations provided by the theme.

Types of plugins

• Built-in plugins: each theme offers predefined plugins
• Custom plugins: you can create your own plugins, which can even be integrated into other plugins

Best practice: use the custom_ prefix to name your custom plugins (example: custom_my_plugin) to avoid any conflicts if a future theme version introduces a plugin with the same name.

Using a plugin

To display a plugin, use the following Liquid tag:

{% plugin plugin_name %}

The editor offers autocompletion with the complete list of plugins available for your theme version.

Advanced function: Override (template replacement)

To completely replace a template, add the {% break %} tag at the very end of your plugin snippet.

Important:

• This function only applies to plugins whose name starts with template_
• The {% break %} tag must be the very last thing in the snippet (no space or character after)

Practical example: Modifying your site footer

Steps to follow

1. Activation: contact us to activate the feature on your account
2. Access Plugins: log in to your Smily account and go to the Website application, "Plugins" section
3. Create a new plugin: click on "New Plugin"

4. Copy the template: the footer code is located in Templates > Components > footer.liquid

5. Paste the template into a new Plugin and modify the code: customize the template according to your needs

Starting code for the footer

{% plugin footer %}

The complete footer template contains all the code necessary to customize the appearance and content of your footer.

Modifiable templates (Theme v3)

Here is the list of locations where you can insert your custom plugins:

Structural locations

• before_content_for_header
• before_head_end
• after_body_start
• before_content_for_layout
• before_body_end

Site sections

• header (header)
• footer (footer)

Pages and templates

• template_404 (error page)
• template_campaign (campaign page)
• template_category (category page)
• template_contact (contact page)
• template_cookies (cookies page)
• template_destination (destination page)
• template_index (home page)
• template_page_content_large (large page content)
• template_page_content (page content)
• template_title (page title)
• template_page (standard page)
• template_password (password-protected page)
• template_rental (rental page)
• template_search (search page)
• template_suggested_rentals (rental suggestions)

Getting started

Interested? Contact our team to activate Plugins on your Smily account. We remain at your disposal to support you in your first customizations!