PHPackages                             pixelstudio/wp-custy - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. pixelstudio/wp-custy

AbandonedWordpress-plugin

pixelstudio/wp-custy
====================

Add more variety of options such as Typography and Color Picker to WP Customizer.

1.5.4(5y ago)510MITJavaScriptPHP >=7.0.0

Since Mar 17Pushed 5y ago1 watchersCompare

[ Source](https://github.com/hrsetyono/wp-custy)[ Packagist](https://packagist.org/packages/pixelstudio/wp-custy)[ Docs](https://github.com/hrsetyono/wp-custy/)[ RSS](/packages/pixelstudio-wp-custy/feed)WikiDiscussions master Synced 5d ago

READMEChangelog (10)Dependencies (1)Versions (17)Used By (0)

Custy - Advanced WordPress Customizer
=====================================

[](#custy---advanced-wordpress-customizer)

> This is a fork of [Blocksy Customizer](https://creativethemes.com/blocksy/), with many added features like automatic CSS output and simpler parameters.

This plugin adds variety options such as Typography and Color Picker to WP Customizer.

[![](https://camo.githubusercontent.com/20ad1256ca1d0492da5120f6ac3a1aecdd497f26f2df324150ac753a18aa824f/68747470733a2f2f7261772e6769746875622e636f6d2f6872736574796f6e6f2f63646e2f6d61737465722f626c6f636b73792f646f632d73656374696f6e2d707265766965772e6a7067)](https://camo.githubusercontent.com/20ad1256ca1d0492da5120f6ac3a1aecdd497f26f2df324150ac753a18aa824f/68747470733a2f2f7261772e6769746875622e636f6d2f6872736574796f6e6f2f63646e2f6d61737465722f626c6f636b73792f646f632d73656374696f6e2d707265766965772e6a7067)

It also comes with drag-n-drop builder for Header and Footer:

[![](https://camo.githubusercontent.com/144f0e4d4e4e528605e2b61cf9ed15cf2e91661b3dd0930dcdc7ef1f4cc67a86/68747470733a2f2f7261772e6769746875622e636f6d2f6872736574796f6e6f2f63646e2f6d61737465722f626c6f636b73792f646f632d6275696c6465722e6a7067)](https://camo.githubusercontent.com/144f0e4d4e4e528605e2b61cf9ed15cf2e91661b3dd0930dcdc7ef1f4cc67a86/68747470733a2f2f7261772e6769746875622e636f6d2f6872736574796f6e6f2f63646e2f6d61737465722f626c6f636b73792f646f632d6275696c6465722e6a7067)

1. GETTING STARTED
------------------

[](#1-getting-started)

Download this repo, put it in your `/plugins` folder, install it, and activate this plugin.

If you use [Composer to install plugin](https://wptips.dev/composer-to-manage-plugins/), this plugin is available with the name `pixelstudio/wp-custy`.

Then go to Appearance > Customizer and you will see these default sections:

1. **General** - Contains options for color palette, shadow, and site width.
2. **Text** - Contains options for Body and Heading typography.
3. **Header** - Contains drag-n-drop builder for Header.
4. **Footer** - Contains drag-n-drop builder for Footer.

2. TERMINOLOGY
--------------

[](#2-terminology)

- **Option** - Each individual setting. For example (see 1st picture above): Root Typography, Small Font Size
- **Section** - The whole column of options. For example: General, Text
- **Builder** - Either Header or Footer drag-n-drop setting.
- **Item** - Set of options that can be placed in Header or Footer. For example (see 2nd picture above): Button, Logo

3. USING CSS OPTIONS
--------------------

[](#3-using-css-options)

Across the options, you might notice this CSS toggle:

[![](https://camo.githubusercontent.com/ab084d7b19b33d1c79f61f7d30a002abe96fb9815418e62201cc38a45f3d2f20/68747470733a2f2f7261772e6769746875622e636f6d2f6872736574796f6e6f2f63646e2f6d61737465722f626c6f636b73792f646f632d6373732d7661722e6a7067)](https://camo.githubusercontent.com/ab084d7b19b33d1c79f61f7d30a002abe96fb9815418e62201cc38a45f3d2f20/68747470733a2f2f7261772e6769746875622e636f6d2f6872736574796f6e6f2f63646e2f6d61737465722f626c6f636b73792f646f632d6373732d7661722e6a7067)

That means the value of that options is automatically outputted into `:root` (by default) using that variable name.

Then implement that variable in your theme wherever it fits.

4. ADD NEW SECTION
------------------

[](#4-add-new-section)

Let's say we want to add a new section where we can toggle on and off various features. Use this filter below:

```
add_filter( 'custy_sections', function( $sections ) {

  $sections[ 'features' ] = [
    'title' => __( 'Features' ),
    'container' => [ 'priority' => 10 ],
    'options' => [

      'has_back_to_top' => [
        'label' => __( 'Has Back to Top?' ),
        'type' => 'ct-switch',
      ],

      'has_fixed_header' => [
        'label' => __( 'Has Fixed Header?' ),
        'type' => 'ct-switch',
      ],

      'has_blog_sidebar' => [
        'label' => __( 'Has Blog Sidebar?' ),
        'type' => 'ct-switch',
      ],

    ]
  ];

  return $sections;
} );
```

Then, define the **default values** of those new options:

```
add_filter( 'custy_default_values', function( $defaults ) {

  $defaults = wp_parse_args( [

    'has_back_to_top' => 'yes',
    'has_fixed_header' => 'no',
    'has_blog_sidebar' => 'yes',

  ], $defaults );

  return $defaults;
} );
```

Done!, Check out the Customizer and you will see a new section called "Features"

[![](https://camo.githubusercontent.com/64f477f94207dadf5be28cb52e8ed4806ae22a10b756e147b8adc449c05cfa7b/68747470733a2f2f7261772e6769746875622e636f6d2f6872736574796f6e6f2f63646e2f6d61737465722f626c6f636b73792f637573746f6d2d73656374696f6e2e6a7067)](https://camo.githubusercontent.com/64f477f94207dadf5be28cb52e8ed4806ae22a10b756e147b8adc449c05cfa7b/68747470733a2f2f7261772e6769746875622e636f6d2f6872736574796f6e6f2f63646e2f6d61737465722f626c6f636b73792f637573746f6d2d73656374696f6e2e6a7067)

> Check out the [Wiki](https://github.com/hrsetyono/wp-custy/wiki/) for complete information on Options type and other things.

5. USING NON-CSS OPTIONS
------------------------

[](#5-using-non-css-options)

Use the function `Custy::get_mod( $option_id )` like shown below:

```
if( Custy::get_mod('has_back_to_top') == 'yes' ) {
  // output the back to top markup
}
```

> To make it easy to remember what the option ID is, the label should be the same. For example: the label for `has_back_to_top` is "Has Back to Top?"

6. MORE INFO AT WIKI
--------------------

[](#6-more-info-at-wiki)

I have prepared tons of information at [Wiki](https://github.com/hrsetyono/wp-custy/wiki) including:

- All available options type like [Color Picker](https://github.com/hrsetyono/wp-custy/wiki/Type-%E2%80%93-Color-Picker), [Slider](https://github.com/hrsetyono/wp-custy/wiki/Type-%E2%80%93-Slider), and [Radio](https://github.com/hrsetyono/wp-custy/wiki/Type-%E2%80%93-Radio)
- [Adding new item to the Builder](https://github.com/hrsetyono/wp-custy/wiki/Builder-%E2%80%93-Add-New-Item)
- [Rendering Header or Footer](https://github.com/hrsetyono/wp-custy/wiki/Builder-%E2%80%93-Rendering)
- List of default values for [built-in Section](https://github.com/hrsetyono/wp-custy/wiki/Default-Value), [Header](https://github.com/hrsetyono/wp-custy/wiki/Default-Value-%E2%80%93-Header), and [Footer](https://github.com/hrsetyono/wp-custy/wiki/Default-Value-%E2%80%93-Footer)

7. THEME BUILT WITH CUSTY
-------------------------

[](#7-theme-built-with-custy)

- [Edje WP Theme](https://github.com/hrsetyono/edje-wp-theme) - My own WP starter theme using Timber Library.
- [Blocksy](https://creativethemes.com/blocksy/) - The theme where this customizer originated. It is an amazing theme and I used it on my [WPTips.dev Blog](http://wptips.dev/), but the customizer is hard to edit because it lacks filter.

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~4 days

Total

16

Last Release

2188d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/4ef32322d0bfb4c0bf00b283c6dc1013b9fbf4bc9da57dce540f4cff6474e394?d=identicon)[pixelstudio](/maintainers/pixelstudio)

---

Top Contributors

[![hrsetyono](https://avatars.githubusercontent.com/u/3876541?v=4)](https://github.com/hrsetyono "hrsetyono (26 commits)")

---

Tags

pluginwordpresslibrarycustomizer

### Embed Badge

![Health badge](/badges/pixelstudio-wp-custy/health.svg)

```
[![Health](https://phpackages.com/badges/pixelstudio-wp-custy/health.svg)](https://phpackages.com/packages/pixelstudio-wp-custy)
```

###  Alternatives

[10up/elasticpress

Supercharge WordPress with Elasticsearch.

1.3k374.3k6](/packages/10up-elasticpress)[redux-framework/redux-framework

Build better and beautiful sites in WordPress, faster.

1.8k6.2k](/packages/redux-framework-redux-framework)[sybrew/the-seo-framework

An automated, advanced, accessible, unbranded and extremely fast SEO solution for any WordPress website.

47078.8k](/packages/sybrew-the-seo-framework)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)