User Contributed Notes

1. Skip to note 15 content

   
   Binsaifullah
   
   
   7 years ago
   

   You must log in to vote on the helpfulness of this noteVote results for this note: 8You must log in to vote on the helpfulness of this note

   /**
    * Essential theme supports
    * */
   function theme_setup(){
       /** automatic feed link*/
       add_theme_support( 'automatic-feed-links' );
   
       /** tag-title **/
       add_theme_support( 'title-tag' );
   
       /** post formats */
       $post_formats = array('aside','image','gallery','video','audio','link','quote','status');
       add_theme_support( 'post-formats', $post_formats);
   
       /** post thumbnail **/
       add_theme_support( 'post-thumbnails' );
   
       /** HTML5 support **/
       add_theme_support( 'html5', array( 'comment-list', 'comment-form', 'search-form', 'gallery', 'caption' ) );
   
       /** refresh widgest **/
       add_theme_support( 'customize-selective-refresh-widgets' );
   
       /** custom background **/
       $bg_defaults = array(
           'default-image'          => '',
           'default-preset'         => 'default',
           'default-size'           => 'cover',
           'default-repeat'         => 'no-repeat',
           'default-attachment'     => 'scroll',
       );
       add_theme_support( 'custom-background', $bg_defaults );
   
       /** custom header **/
       $header_defaults = array(
           'default-image'          => '',
           'width'                  => 300,
           'height'                 => 60,
           'flex-height'            => true,
           'flex-width'             => true,
           'default-text-color'     => '',
           'header-text'            => true,
           'uploads'                => true,
       );
       add_theme_support( 'custom-header', $header_defaults );
   
       /** custom log **/
       add_theme_support( 'custom-logo', array(
           'height'      => 60,
           'width'       => 400,
           'flex-height' => true,
           'flex-width'  => true,
           'header-text' => array( 'site-title', 'site-description' ),
       ) );
   
   
   
   }
   add_action('after_setup_theme','theme_setup');

2. Skip to note 16 content

   
   Joy
   
   
   9 years ago
   

   You must log in to vote on the helpfulness of this noteVote results for this note: 7You must log in to vote on the helpfulness of this note

   Feedback:
   There needs to be a section for starter content.
   This page has good explanation https://make.wordpress.org/core/2016/11/30/starter-content-for-themes-in-4-7/
   and this function shows all the default values: https://developer.wordpress.org/reference/functions/get_theme_starter_content/

3. Skip to note 17 content

   
   Birgit Pauli-Haack
   
   
   7 years ago
   

   You must log in to vote on the helpfulness of this noteVote results for this note: 6You must log in to vote on the helpfulness of this note

   Enabling theme support for align full and align wide option for the block editor, use
   add_theme_support( 'align-wide' );

4. Skip to note 18 content

   
   Marcio Duarte
   
   
   4 years ago
   

   You must log in to vote on the helpfulness of this noteVote results for this note: 5You must log in to vote on the helpfulness of this note

   The following features are enabled by default in block themes from version 5.9 onwards:

   • post-thumbnails
   • responsive-embeds
   • editor-styles
   • html5
   • automatic-feed-links

   See #35593 | (source)

5. Skip to note 19 content

   
   Matt Radford
   
   
   6 years ago
   

   You must log in to vote on the helpfulness of this noteVote results for this note: 4You must log in to vote on the helpfulness of this note

   From WP 5.3, add_theme_support('html5', ['script', 'style']); removes type="text/javascript" and type=”text/css” from enqueued scripts and styles.

   See https://make.wordpress.org/core/2019/10/15/miscellaneous-developer-focused-changes-in-5-3/ – HTML5 Supports Argument for Script and Style Tags

6. Skip to note 20 content

   
   Cameron Jones
   
   
   6 years ago
   

   You must log in to vote on the helpfulness of this noteVote results for this note: 2You must log in to vote on the helpfulness of this note

   To determine if the theme support exists (and retrieve it’s arguments), use get_theme_support( $feature )

   https://developer.wordpress.org/reference/functions/get_theme_support/

7. Skip to note 21 content

   
   puggan
   
   
   6 years ago
   

   You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

   The Changelog missing the row:
   “The html5 feature now also accepts ‘script and ‘style’.”

   Don’t know what version it was added in, but its there in 5.3.1 atleast.

   Exemple of use:
   https://github.com/WordPress/WordPress/blob/48692b65241fcbadcd686c3f66696e16883a0e83/wp-includes/theme.php#L708
   https://github.com/WordPress/WordPress/blob/48692b65241fcbadcd686c3f66696e16883a0e83/wp-includes/theme.php#L3233

   Commit:
   https://github.com/WordPress/WordPress/commit/252628652e7706cabb3913f4aa57218fa5012e4b

8. Skip to note 22 content

   
   Will Skora
   
   
   6 years ago
   

   You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

   Note that you have to individually call each of these; including multiple ones as an array <br />
add_theme_support( array( 'editor-styles', 'align-wide' ) )<br />


   Instead, you must call them individually:

   add_theme_support( 'editor-styles' );
   add_theme_support( 'align-wide' );

9. Skip to note 23 content

   
   Marcio Zebedeu
   
   
   6 years ago
   

   You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

   Declare support for navigation widgets markup.

   add_theme_support( 'html5', array( 'navigation-widgets' ) );

   “Theme developers are highly encouraged to utilize this improvement in their themes. This new theme support feature is an easy way to improve semantics and accessibility in all of the sites using your theme.”

10. Skip to note 24 content

    
    benoitadam
    
    
    5 years ago
    

    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

    “default-color” for custom background doesn’t work

    Solution is to define your own stylesheet class and add the CSS class to the body tag.

    • The default-color argument doesn’t actually set the background color: the theme has to implement the default color using CSS.

      crstauf 5 years ago

11. Skip to note 25 content

    
    Farrukh Hassan
    
    
    5 years ago
    

    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

    Declare support for Block Styles.

    add_theme_support( 'wp-block-styles' );

    These will enable the support for default Gutenberg block styles in the theme.

    • View Docs

      Jacopo Marrone (@tresorama) 3 years ago

12. Skip to note 26 content

    
    birgandi
    
    
    4 years ago
    

    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

    deactivate new block editor Widget and active old editor Widget

    remove_theme_support( 'widgets-block-editor' );

13. Skip to note 27 content

    
    Lovro Hrust
    
    
    4 years ago
    

    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

    If you enable 'responsive-embeds', these are responsive classes you can use (.wp-embed-aspect-21-9) etc. on embedded block (like e.g. youtube):

    .wp-embed-responsive .wp-embed-aspect-21-9 .wp-block-embed__wrapper::before {
      padding-top: 42.85%;
    }
    .wp-embed-responsive .wp-embed-aspect-18-9 .wp-block-embed__wrapper::before {
      padding-top: 50%;
    }
    .wp-embed-responsive .wp-embed-aspect-16-9 .wp-block-embed__wrapper::before {
      padding-top: 56.25%;
    }
    .wp-embed-responsive .wp-embed-aspect-4-3 .wp-block-embed__wrapper::before {
      padding-top: 75%;
    }
    .wp-embed-responsive .wp-embed-aspect-1-1 .wp-block-embed__wrapper::before {
      padding-top: 100%;
    }
    .wp-embed-responsive .wp-embed-aspect-9-16 .wp-block-embed__wrapper::before {
      padding-top: 177.77%;
    }
    .wp-embed-responsive .wp-embed-aspect-1-2 .wp-block-embed__wrapper::before {
      padding-top: 200%;
    }

14. Skip to note 28 content

    
    justinmahar
    
    
    8 years ago
    

    You must log in to vote on the helpfulness of this noteVote results for this note: -1You must log in to vote on the helpfulness of this note

    Starter Content #

    Defines and registers starter content to showcase themes on new sites.

    add_theme_support( 'starter-content', array(
        // Place widgets in the desired locations (such as sidebar or footer).
        // Example widgets: archives, calendar, categories, meta, recent-comments, recent-posts, 
        //                  search, text_business_info, text_about
        'widgets'     => array( 'sidebar-1' => array( 'search', 'categories', 'meta'), ),
        // Specify pages to create, and optionally add custom thumbnails to them.
        // Note: For thumbnails, use attachment symbolic references in {{double-curly-braces}}.
        // Post options: post_type, post_title, post_excerpt, post_name (slug), post_content, 
        //               menu_order, comment_status, thumbnail (featured image ID), and template
        'posts'       => array( 'home', 'about', 'blog' => array( 'thumbnail' => '{{image-cafe}}' ), ),
        // Create custom image attachments used as post thumbnails for pages.
        // Note: You can reference these attachment IDs in the posts section above. Example: {{image-cafe}}
        'attachments' => array( 'image-cafe' => array( 'post_title' => 'Cafe', 'file' => 'assets/images/cafe.jpg' ), ),
        // Assign options defaults, such as front page settings.
        // The 'show_on_front' value can be 'page' to show a specified page, or 'posts' to show your latest posts.
        // Note: Use page ID symbolic references from the posts section above wrapped in {{double-curly-braces}}.
        'options'     => array( 'show_on_front'  => 'page', 'page_on_front' => '{{home}}', 'page_for_posts' => '{{blog}}', ),
    	// Set the theme mods.
        'theme_mods'  => array( 'panel_1' => '{{about}}' ),
    	// Set up nav menus.
        'nav_menus'   => array( 'top' => array( 'name' => 'Top Menu', 'items' => array( 'link_home', 'page_about', 'page_blog' )), ),
    ) );

    For full examples of each option, you can reference the Twenty Seventeen theme’s functions.php:

    https://github.com/xwp/wordpress-develop/blob/master/src/wp-content/themes/twentyseventeen/functions.php#L117