WordPress allows theme developers to make their themes customizable through advanced PHP solution called hooks. There are 2 types of hooks: actions and filters. Chipmunk uses filter functionality to allow advanced users to modify some parts of the theme.

To be able to use our custom filters, you’ll need to create a child theme or use our example child theme available to download here.

Add custom Google Fonts

chipmunk_google_fonts

functions.php
function chipmunk_custom_google_fonts($fonts)
{
  $custom_fonts = [
    "Open Sans Condensed" => "Open Sans Condensed",
    "Merriweather" => "Merriweather",
  ];

  return array_merge($fonts, $custom_fonts);
}

add_filter("chipmunk_google_fonts", "chipmunk_custom_google_fonts");

Add custom social profiles

chipmunk_socials

functions.php
function chipmunk_custom_socials($socials)
{
  $custom_socials = ["Digg"];

  return array_merge($socials, $custom_socials);
}

add_filter("chipmunk_socials", "chipmunk_custom_socials");

Change tile excerpt length

chipmunk_{type}_excerpt_length

Replace {type} with either post, resource or collection.

functions.php
function chipmunk_excerpt_length()
{
  return 20;
}
add_filter("chipmunk_post_excerpt_length", "chipmunk_excerpt_length");
add_filter("chipmunk_resource_excerpt_length", "chipmunk_excerpt_length");
add_filter("chipmunk_collection_excerpt_length", "chipmunk_excerpt_length");

Re-order or remove resource tabs

chipmunk_resource_tabs

functions.php
// Re-order the resource tabs
function chipmunk_reorder_resource_tabs()
{
  return ["popular", "latest", "featured"];
}
add_filter("chipmunk_resource_tabs", "chipmunk_reorder_resource_tabs");

// Remove the resource tabs completely
function chipmunk_remove_resource_tabs()
{
  return [];
}
add_filter("chipmunk_resource_tabs", "chipmunk_remove_resource_tabs");

Change default required submission fields

chipmunk_submission_required_fields

functions.php
function chipmunk_submission_required_fields()
{
  return ["name", "collection"];
}
add_filter("chipmunk_submission_required_fields", "chipmunk_submission_required_fields");

Change default submission post status

chipmunk_submission_post_status

functions.php
// Automatically publish resource submissions
function chipmunk_submission_post_status()
{
  return "publish";
}
add_filter("chipmunk_submission_post_status", "chipmunk_submission_post_status");

Change max length of category names

chipmunk_term_max_length

functions.php
// Change default maximum length of collection/category names in meta tags
function chipmunk_change_term_max_length()
{
  return 50; // Use 0 to display full term name
}
add_filter("chipmunk_term_max_length", "chipmunk_change_term_max_length");

Shuffle term names in meta bar

chipmunk_shuffle_terms

functions.php
function chipmunk_enable_shuffle_terms()
{
  return true;
}
add_filter("chipmunk_shuffle_terms", "chipmunk_enable_shuffle_terms");

Change the newsletter email field name

chipmunk_newsletter_email_field

Useful if you have a custom form with a different field name.

functions.php
function chipmunk_change_newsletter_email_field()
{
  return "email";
}
add_filter("chipmunk_newsletter_email_field", "chipmunk_change_newsletter_email_field");

Add extra hidden input fields

chipmunk_newsletter_args

Some email providers require additional hidden fields to be sent with the form. You can add them using this filter.

functions.php
function chipmunk_change_newsletter_args()
{
  return [
    "meta_required" => "email",
    "redirect" => "https://example.com",
  ];
}
add_filter("chipmunk_newsletter_args", "chipmunk_change_newsletter_args");