Extend | Useful instructions on how to extend your Creatus WordPress Theme

Creatus Child Theme

themezly — Wed, 15 Feb 2017 19:08:16 +0000

Once you install and activate Creatus WordPress Theme you are taken to the Auto Setup screen that gives you two auto setup options that automatically download and activate Creatus Child Theme.

Plugins & Demo Content - installs all required plugins and dependencies and redirects to demo content install screen
Plugins Only - installs all required plugins and dependencies

Clicking on any of the two options will auto install and activate Creatus child theme for you. We strongly recommend to use child-theme to make sure that your custom changes will still be effective after the theme has been updated.

Why use child theme?

WordPress child theme inherits all features and functionalities from a parent theme. This way you can modify or extend parent theme without changing it and any future theme updates are not going to remove your custom theme modifications.

Beside being able to extend the theme files, with Creatus you can also extend or modify the parent theme framework theme options, shortcodes ( elements ), extensions or widgets;

Extend Creatus theme options

If theme options set is located in Creatus framework theme options folder, the Creatus child theme is able to override the options set files by copying the file in to child theme corresponding folder;

├─creatus/
│ ├─inc/
│ └──thzframework/
│     └─theme/
│       └─options/
│         ├─posts/
│         └──post_media.php
│   
└─creatus-child/
  ├─inc/
  └──thzframework/
      └─theme/
        └─options/
          ├─posts/
          └──post_media.php

Extend Creatus shortcodes ( elements )

If a shortcode is located in Creatus framework extensions shortcodes folder, the Creatus child theme is able to override the shortcode files by copying them in to child theme corresponding folder;

├─creatus/
│ ├─inc/
│ └──thzframework/
│     └─extensions/
│       └─shortcodes/
│         ├─shortcodes/
│         ├──text/
│         └───...
│   
└─creatus-child/
  ├─inc/
  └──thzframework/
      └─extensions/
        └─shortcodes/
          ├─shortcodes/
          ├──text/
          └───...

Extend Creatus extensions

If an extension is located in Creatus framework extensions folder, the Creatus child theme is able to override the extension files by copying them in to child theme corresponding folder;

├─creatus/
│ ├─inc/
│ └──thzframework/
│     └─extensions/
│       └─megamenu/
│         ├─views/
│         └──item-link.php
│   
└─creatus-child/
  ├─inc/
  └──thzframework/
      └─extensions/
        └─megamenu/
          ├─views/
          └──item-link.php

Extend Creatus widgets

If a widget is located in Creatus inc widgets folder, the Creatus child theme is able to override the widget.php file by copying it to child theme corresponding folder;

├─creatus/
│ ├─inc/
│ └──widgets/
│     └─thz-flickr/
│       └─views/
│         └──widget.php
│   
└─creatus-child/
  ├─inc/
  └──widgets/
      └─thz-flickr/
        └─views/
          └──widget.php

Info

For more information about Unyson extensions and shortcodes extend please visit Unyson Theme Framework manual.

The post Creatus Child Theme appeared first on Themezly™.

Custom Theme Options

themezly — Wed, 15 Feb 2017 19:12:36 +0000

Creatus theme options are separated in to corresponding options files and are located in creatus/inc/thzframework/options folder. Each of these files can be changed or extended.

If theme options set file is located in Creatus framework theme options folder, the Creatus child theme is able to override the options set files by copying the file in to creatus-child theme corresponding folder;

├─creatus/
│ ├─inc/
│ └──thzframework/
│     └─theme/
│       └─options/
│         ├─posts/
│         └──post_media.php
│   
└─creatus-child/
  ├─inc/
  └──thzframework/
      └─theme/
        └─options/
          ├─posts/
          └──post_media.php

Once you copy the file over you can make desired changes to theme option file and extend your creatus-child theme options.

Info

Please note that theme options extend is your responsibility and we offer only limited support fur such tasks.

The post Custom Theme Options appeared first on Themezly™.

Custom Theme Presets

themezly — Wed, 15 Feb 2017 19:09:07 +0000

Creatus WordPress Theme comes with presets Export/import utility that will help you create custom theme presets. For your convenience we have gathered a list of theme presets that come in handy when you don't need the complete theme demo but rather just want the demo theme settings.

Creating new theme preset

To create new theme preset, adjust the theme settings the way you need them, go to theme Export/import tab, click on Export theme settings button and save the preset in child theme presets folder. Note that preset file must be .json type;

├─creatus-child/
  ├─inc/
  └──thzframework/
      └─presets/
          └──preset_name.json

Assign custom default theme preset

To assign a custom theme preset to be a default preset on theme install or reset button click add this filter in your creatus child theme functions.php;

function my_filter_default_theme_preset(){
    return 'preset_name';
}

add_filter( 'thz_filter_set_preset', 'my_filter_default_theme_preset');

Custom preset CSS file

If you are using custom theme presets you can also take advantage of custom theme preset CSS file and auto load assigned preset CSS file. To do so simple create preset_name.css file and add it in creatus-child assets CSS folder;

├─creatus-child/
  ├─assets/
  └──css/
       └─preset_name.css

The post Custom Theme Presets appeared first on Themezly™.

Custom Widgets

themezly — Wed, 15 Feb 2017 19:09:07 +0000

Creatus WordPress theme comes with custom widgets that you can take advantage of. You can extend these widgets at any time. If a widget is located in Creatus inc widgets folder, the Creatus child theme is able to override the widget.php file by copying it to child theme corresponding folder;

├─creatus/
│ ├─inc/
│ └──widgets/
│     └─thz-flickr/
│       └─views/
│         └──widget.php
│   
└─creatus-child/
  ├─inc/
  └──widgets/
      └─thz-flickr/
        └─views/
          └──widget.php

Once you copy the file over you can make desired changes to widget file and extend your creatus-child theme widget.

Info

Please note that widget extend is your responsibility and we offer only limited support fur such tasks.

The post Custom Widgets appeared first on Themezly™.

Custom Extensions

themezly — Mon, 26 Jun 2017 20:07:17 +0000

Creatus WordPress theme comes with extended Unyson framework extensions that you can take advantage of. You can extend these extensions at any time. If an extension is located in Creatus framework extensions folder, the Creatus child theme is able to override the extension files by copying them in to child theme corresponding folder;

├─creatus/
│ ├─inc/
│ └──thzframework/
│     └─extensions/
│       └─megamenu/
│         ├─views/
│         └──item-link.php
│   
└─creatus-child/
  ├─inc/
  └──thzframework/
      └─extensions/
        └─megamenu/
          ├─views/
          └──item-link.php

Once you copy the files over you can make desired changes to extension files and extend your creatus-child theme extensions.

Info

Please note that shortcodes extend is your responsibility and we offer only limited support fur such tasks.

Creating custom extension

Creatus theme is built on top of Unyson theme framework and you can take advantage of all it's extending features. To create new extension from scratch follow this useful Unyson Extension Cookbook instructions.

The post Custom Extensions appeared first on Themezly™.

Custom Shortcodes

themezly — Wed, 15 Feb 2017 19:09:01 +0000

Creatus WordPress theme comes with over 40 shortcodes ( elements ) that you can take advantage of. You can extend these shortcodes at any time. If a shortcode is located in Creatus framework extensions shortcodes folder, the Creatus child theme is able to override the shortcode files by copying them in to child theme corresponding folder;

├─creatus/
│ ├─inc/
│ └──thzframework/
│     └─extensions/
│       └─shortcodes/
│         ├─shortcodes/
│         ├──text/
│         └───...
│   
└─creatus-child/
  ├─inc/
  └──thzframework/
      └─extensions/
        └─shortcodes/
          ├─shortcodes/
          ├──text/
          └───...

Once you copy the files over you can make desired changes to shortcode files and extend your creatus-child theme shortcode.

Info

Please note that shortcodes extend is your responsibility and we offer only limited support fur such tasks.

Creating custom shortcode

Creatus theme is built on top of Unyson theme framework and you can take advantage of all it's extending features. To create new shortcode from scratch follow this useful Unyson Shortcode Cookbook instructions.

The post Custom Shortcodes appeared first on Themezly™.

Hooks and Filters

themezly — Fri, 07 Sep 2018 11:09:10 +0000

Creatus WordPress Theme comes with several WordPress hooks and filters that can help you extend or change theme functionality. To use the filter or hook just copy the snippet to your creatus-child/functions.php file and hit save.

Change logo html tag

// logoid | logo = default header logo |  logomobile =  mobile menu logo
function my_filter_textual_logo_data( $data ){

    $h_tag = is_front_page() && 'logo' == $data['logoid'] ? 'h1' :'div';

    $data['tag'] = $h_tag;

    return $data;
}

add_filter( 'thz_filter_textual_logo_data', 'my_filter_textual_logo_data' );

Change Image logo alt tags

function my_filter_image_logo_alt() {
    return 'My logo alt';
}
add_filter( 'thz_filter_logo_alt', 'my_filter_image_logo_alt' );

function my_filter_mini_header_image_logo_alt() {
    return 'My mini logo alt';
}
add_filter( 'thz_filter_mini_logo_alt', 'my_filter_mini_header_image_logo_alt' );

Add standard font to typography option font list

function my_filter_standard_fonts() {
    return array('Verdana, Geneva, sans-serif' =>'Verdana, Geneva, sans-serif');
}
add_filter( 'thz_typography_standard_fonts', 'my_filter_standard_fonts' );

Change widget list class

function my_filter_list_class_name(){
    return 'my-awesome-lists-class-name';
}

add_filter( 'thz_filter_list_class', 'my_filter_list_class_name');

Add more colors to theme colors palette

You must use color_ prefix for the colors to be recongnized.

function my_filter_add_palette_colors( $palette ){
    $palette['color_11']='#ff6600';
    return $palette;
}
add_filter('thz_filter_palette_colors', 'my_filter_add_palette_colors' );

Include files action

The do_action( 'thz_filter_init_includes' ); fires before any Creatus files inclusion. This way you can add own files on init.

function my_filter_init_include_files (){

    require_once get_stylesheet_directory_uri(). '/inc/my-awesome-class.php';
}

add_action('thz_filter_init_includes','my_filter_init_include_files');

Add own local host to combine shortcodes CSS files

If you are working on your localhost, during changes of any builder elements CSS files there is a function that runs only if files have been changed and it is combining all elements CSS in to the thz-shortcodes.css file. This is the default local hosts list.

$locals = array(
    'localhost', 
    '127.0.0.1', 
    '192.168',
    '.test', 
    '.example', 
    '.invalid', 
);

If the function does not run for you or you need to add a new local to the list use this filter

function my_filter_add_local_host ( $local_hosts ){
    $local_hosts[]='my_local_host';
    return $local_hosts;
}

add_filter('thz_filter_combine_shortcodes_local_hosts', 'my_filter_add_local_host' );

Enable Gutenberg ( block ) editor

By default Creatus disables Gutenberg editor and let you use the Tinymce editor for all posts types and pages. To modify this filter or enable Gutenberg on specific post type you can re-declare the filter function in your child theme functions.php file.

/*
 * Disable block editor
 * in case you need some logic see:
 * https://gist.github.com/danyj/ec00057550fd6f73995ab2f8fc8b729f
 */
function _thz_filter_disable_block_editor_pt( $use_block_editor, $post_type ){

  $use_block_editor = true;
  return  $use_block_editor;

}

The post Hooks and Filters appeared first on Themezly™.

Changing Theme Admin Splash Image

themezly — Wed, 15 Feb 2017 19:13:28 +0000

To override Creatus theme settings admin splash image, create an image by name admin-splash.png and save it in creatus-child theme folder;

├─creatus-child/
    └─admin-splash.png

The post Changing Theme Admin Splash Image appeared first on Themezly™.