{"id":482,"date":"2011-08-18T08:39:12","date_gmt":"2011-08-18T08:39:12","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/one-click-child-theme\/"},"modified":"2015-05-13T22:31:05","modified_gmt":"2015-05-13T22:31:05","slug":"one-click-child-theme","status":"closed","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/one-click-child-theme\/","author":12654,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.6","stable_tag":"trunk","tested":"4.1.42","requires":"3.0","requires_php":"","requires_plugins":"","header_name":"One-Click Child Theme","header_author":"tychay","header_description":"","assets_banners_color":"bea7a0","last_updated":"2017-11-28 05:06:21","external_support_url":"","external_repository_url":"","donate_link":"http:\/\/www.kiva.org\/lender\/tychay","header_plugin_uri":"http:\/\/terrychay.com\/wordpress-plugins\/one-click-child-theme","header_author_uri":"http:\/\/terrychay.com\/","rating":4.7,"author_block_rating":0,"active_installs":10000,"downloads":396311,"num_ratings":0,"support_threads":1,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":[],"ratings":{"1":"4","2":0,"3":"2","4":"7","5":"65"},"assets_icons":{"icon.svg":{"filename":"icon.svg","revision":"1121861","resolution":"","location":"assets"}},"assets_banners":{"banner-1544x500.jpg":{"filename":"banner-1544x500.jpg","revision":"1121868","resolution":"1544x500","location":"assets"},"banner-772x250.jpg":{"filename":"banner-772x250.jpg","revision":"1121868","resolution":"772x250","location":"assets"}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":[],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":"1119234","resolution":"1","location":"assets"},"screenshot-2.png":{"filename":"screenshot-2.png","revision":"1119234","resolution":"2","location":"assets"},"screenshot-3.png":{"filename":"screenshot-3.png","revision":"1119234","resolution":"3","location":"assets"}},"screenshots":{"1":"To use the plugin, click one of these two palces in the Appearance section of your <code>wp_admin<\/code>","2":"Fill out this form","3":"You will see the theme will be successfully child-themed, but will track the parent theme correctly."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[17319,17324,356,1141],"plugin_category":[],"plugin_contributors":[78129],"plugin_business_model":[],"class_list":["post-482","plugin","type-plugin","status-closed","hentry","plugin_tags-child-theme","plugin_tags-child-theme-creator","plugin_tags-css","plugin_tags-theme","plugin_contributors-tychay","plugin_committers-slocumstudio","plugin_committers-tychay"],"banners":[],"icons":{"svg":"https:\/\/ps.w.org\/one-click-child-theme\/assets\/icon.svg?rev=1121861","icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/one-click-child-theme_bea7a0.svg","icon_2x":false,"generated":true},"screenshots":[{"src":"https:\/\/ps.w.org\/one-click-child-theme\/assets\/screenshot-1.png?rev=1119234","caption":"To use the plugin, click one of these two palces in the Appearance section of your <code>wp_admin<\/code>"},{"src":"https:\/\/ps.w.org\/one-click-child-theme\/assets\/screenshot-2.png?rev=1119234","caption":"Fill out this form"},{"src":"https:\/\/ps.w.org\/one-click-child-theme\/assets\/screenshot-3.png?rev=1119234","caption":"You will see the theme will be successfully child-themed, but will track the parent theme correctly."}],"raw_content":"<!--section=description-->\n<p>Please visit the <a href=\"http:\/\/terrychay.com\/wordpress-plugins\/one-click-child-theme\">plugin homepage<\/a>.<\/p>\n\n<p>Useful for shared hosts, this allows you to easily create child themes from any\ntheme just by clicking.<\/p>\n\n<p>Ever since WordPress 3.0, you shouldn\u2019t directly modify CSS of any downloaded\nthemes because if you update the theme, your changes will be destroyed. Instead, it is recommended that you create a child theme and edit the CSS\nthere so that updates to the parent theme will be inherited instead of destroy\nyour changes.<\/p>\n\n<p>The problem many run into is currently the only way to child theme something\nis edit files on the filesystem. This is non-intuitive for shared-hosting\nsites with one-click WordPress installs (it usually involves a \u201cshell account\u201d\nor learning how to use FTP).<\/p>\n\n<p>This attempts to get around that issue, by adding a button to the themes page\nto allow you to child theme the page. (It\u2019s not really one-click, though.)<\/p>\n\n<p>Inspired by @janeforshort's and @designsimply's WordCamp SF 2011 talk on CSS\ntheming as requested by @sfgirl for <a href=\"http:\/\/pintsizedmusings.com\/\">her blog<\/a>.<\/p>\n\n<!--section=installation-->\n<h3>Installing The Plugin<\/h3>\n\n<p>Extract all files from the ZIP file, making sure to keep the file structure\nintact, and then upload it to <code>\/wp-content\/plugins\/<\/code>. Then just visit your\nadmin area and activate the plugin. That's it!<\/p>\n\n<p><strong>See Also:<\/strong> <a href=\"http:\/\/codex.wordpress.org\/Managing_Plugins#Installing_Plugins\">\"Installing Plugins\" article on the WP Codex<\/a><\/p>\n\n<h3>Using the plugin<\/h3>\n\n<p>If you have the capability to install themes in your admin, then the themes menu\nwill have a new submenu called \"Child Theme\". Clicking on this gives you a form\nthat will allow you to create a child theme based on the current active theme.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt>Installation Instructions<\/dt>\n<dd><h3>Installing The Plugin<\/h3>\n\n<p>Extract all files from the ZIP file, making sure to keep the file structure\nintact, and then upload it to <code>\/wp-content\/plugins\/<\/code>. Then just visit your\nadmin area and activate the plugin. That's it!<\/p>\n\n<p><strong>See Also:<\/strong> <a href=\"http:\/\/codex.wordpress.org\/Managing_Plugins#Installing_Plugins\">\"Installing Plugins\" article on the WP Codex<\/a><\/p>\n\n<h3>Using the plugin<\/h3>\n\n<p>If you have the capability to install themes in your admin, then the themes menu\nwill have a new submenu called \"Child Theme\". Clicking on this gives you a form\nthat will allow you to create a child theme based on the current active theme.<\/p><\/dd>\n<dt>I already modified my CSS in the existing theme? How do I use One Click Child Theme to fix this?<\/dt>\n<dd><p>You can wait for the theme to get updated and have it break it, or you can:<\/p>\n\n<ol>\n<li>Go through the steps for installing and running the plugin above to create a child theme<\/li>\n<li>Click on the <a href=\"http:\/\/codex.wordpress.org\/Appearance_Editor_SubPanel\">Appearance &gt; Editor<\/a> in your admin dashboard menu (or network admin menu if multi-site).<\/li>\n<li>Select the parent theme in the drop down on the right, click <code>Select<\/code> and make sure you are editing the file <code>style.css<\/code> (select on the right).<\/li>\n<li>Copy the changes you made, if you managed to remember them.<\/li>\n<li>Select the child theme you created to the drop down in the left (you should be editing <code>style.css<\/code>).<\/li>\n<li>Paste your changes to the end of the file.<\/li>\n<\/ol><\/dd>\n<dt>Your plugin broke my site!<\/dt>\n<dd><p>I didn't think that's possible, but if so, I want to fix it!<\/p>\n\n<p>First, check what really happened. Is your admin console broken, is the\ntheme broken (go to a new window and check your blog). If a theme fails to\nwork and for some reason I didn't catch that error, WordPress should restore\nthe previous theme (or whatever the default theme is) so your actual blog\nshould be okay and recoverable. If for some reason it didn't default to the\nright theme, go into the Appearance menu and re-enable the parent theme.<\/p>\n\n<p>Then go to the <a href=\"https:\/\/wordpress.org\/support\/plugin\/one-click-child-theme\">support page<\/a>,\ndescribe what happened (screenshots help too) and anything else and we'll try\nour best to help you.<\/p><\/dd>\n<dt>I can't find this Theme Option button you are alluding to in the documentation?<\/dt>\n<dd><p>I really need to update the screenshot. It's still there, but the location has\nchanged as WordPress has been upgraded.<\/p>\n\n<ol>\n<li>Go to the <code>Appearance<\/code> tab<\/li>\n<li>Click on the Active theme (it should say \"Theme Details\" when you mouseover)<\/li>\n<li>An overlay appears. The Theme option button \"Child Theme\" is there<\/li>\n<\/ol><\/dd>\n<dt>When I go to the Child Theme menu, it says \"X is already a child theme\" and I can't create a child theme.<\/dt>\n<dd><p>Making grandchildren of themes is non-trivial, so I disabled the form if it is\nalready a child theme. Instead I offer the ability to repair the Child theme or\ncopy template files from the parent into the child for editing.<\/p><\/dd>\n<dt>Can the plugin be deleted after I create a Child Theme with it?<\/dt>\n<dd><p>Yes. The main purpose of the plugin is fulfilled. Congratulations!\n(Personally, I'd disable it, instead of delete it.)<\/p>\n\n<p>Having said that, there are some things that this plugin help with after your\nchild theme's birth. Think of it as a parenting guide for your new child theme.<\/p><\/dd>\n<dt>Features like?<\/dt>\n<dd><ul>\n<li>Repair a child theme created in the old style.<\/li>\n<li>Copy templates over from your parent theme into your child theme.<\/li>\n<li>Replace the child theme screenshot with one of your site<\/li>\n<\/ul>\n\n<p>When you have an active child theme, click on <code>Appearance &gt; Child Theme<\/code> to\nget to these functions.<\/p><\/dd>\n<dt>What does the \"Repair Child Theme\" button do?<\/dt>\n<dd><p>WordPress changed the <a href=\"http:\/\/codex.wordpress.org\/Child_Themes#How_to_Create_a_Child_Theme\">recommended way of handling parent references in child themes<\/a>.\nIf this plugin detects your child theme was done in the old style, it shows\nthis button. Clicking on it will make the plugin attempt a repair into the\nnew style.<\/p><\/dd>\n<dt>How come the screenshot service just shows a big 404<\/dt>\n<dd><p>The most likely scenario is your WordPress <code>site_url<\/code> isn't publicly\naccessible from the web.<\/p><\/dd>\n<dt>What's with the debugging\/error code on child theme creation?<\/dt>\n<dd><p>You have an old version of this plugin, please update to the latest one.<\/p>\n\n<p>I wrote this plugin back <strong>during<\/strong> a talk at WordCamp SF 2011 about CSS\nThemeing in order to help the person sitting next to me. I just didn't get to\nsome things\u2026 for years. Sorry about that! The debugging code didn't affect any\nbehavior \u2014 it was a sign of me being lazy and not realizing that the plugin\nwould have tens of thousands of avid users!<\/p><\/dd>\n<dt>The theme screenshot service doesn't seem to be working.<\/dt>\n<dd><p>First of all, is the blog accessible from the public Internet? If not, then\nthat is the problem.<\/p>\n\n<p>But sometimes, even then, mshots seems a bit on the slow side. The plugin\nuses WordPress.com\u2019s mShots service. You know, I worked at Automattic for years\non WordPress.com and I still haven't quite figured out mShots. Eventually\nI've gotten the animated loading GIF to be replaced by a real retina-ready JPEG\nscreenshot of my blog homepage. Trust me, when it works, it works great! But\nthe experience may be a little like trying to get a vending machine to accept\na crumpled dollar bill \u2014 Americans know what I mean. Suffice it to say that\nyou might have to hit reload a couple times, or just fiddle around a bit.<\/p><\/dd>\n<dt>Why should I use your plugin and not [_insert competitor here_](https:\/\/wordpress.org\/plugins\/search.php?q=child+theme)<\/dt>\n<dd><p>What? People have forked my idea because I left <a href=\"http:\/\/automattic.com\">Automattic<\/a>\nfor <a href=\"http:\/\/wikimediafoundation.org\/wiki\/Home\">Wikimedia<\/a> three years ago?\nThis means war! Other plugins, you're going down! Steel yourself for the\npent-up aggression of a pointy-haired boss being kept away from a\nprogramming console for years.<\/p>\n\n<p>As to why this plugin is the best? OCCT is Coke Classic to every other plugin's\n<a href=\"http:\/\/en.wikipedia.org\/wiki\/New_Coke\">New Coke<\/a>. Experience the original\nplugin taste your parents knew and loved! Plus, I have\nfour-year old screenshots on my theme page, a way cooler plugin icon, and a\nbaby picture of me and my brother on the banner. Also, this plugin strikes\nthe right balance of features, is free (no \"pro\" version and not even a PayPal\nlink), and (now that I've figured out how to admin the plugin page), I've\nbeen adding volunteers to support it. Even if I sucked into the vortex of\nmiddle management again (isn't going to happen, that s--t is <strong>EVIL<\/strong>) this\nplugin will live forever in the hearts and minds of bloggers everywhere!<\/p>\n\n<p>Which reminds me, if you want to help out, we're cool with that. Like WordPress\nitself, this is a volunteer endeavor. Contact us in the support pages and we'll\nhook you up!<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<p><strong>Version 1.7<\/strong><\/p>\n\n<ul>\n<li>Documentation: FAQ fixes<\/li>\n<\/ul>\n\n<p><strong>Version 1.6<\/strong><\/p>\n\n<ul>\n<li>Feature: Added ability to generate theme screenshots (thanks <a href=\"https:\/\/jane.wordpress.com\/\">@janeforshort\/@jenmylo<\/a> for the idea)<\/li>\n<li>Feature: Redirect to theme page on child theme creation<\/li>\n<li>Feature: Successful child theme creation suggests you edit its <code>style.css<\/code> file<\/li>\n<li>Performance: Only run code in admin page<\/li>\n<li>Bug: Added in some missing gettext<\/li>\n<li>Bug: Removed the double errors\/updates being displays<\/li>\n<li>Documentation: Make sure description is under 140 characters<\/li>\n<li>Documentation: Screenshots now display<\/li>\n<li>Documentation: Added banner image and plugin icon<\/li>\n<li>Documentation: Other minor tweaks including updated FAQ and license<\/li>\n<\/ul>\n\n<p><strong>Version 1.5<\/strong><\/p>\n\n<ul>\n<li>Feature: Added ability to repair child theme<\/li>\n<li>Feature: Added ability to copy any template file from parent theme (thanks <a href=\"http:\/\/michaelrawlins.co.uk\">Michael Rawlings<\/a> for the idea)<\/li>\n<li>Design: Upgrade look of form to resemble most admin forms.<\/li>\n<li>Bug Fix: Properly shows a status message on success.<\/li>\n<li>Documentation: Added section for FAQ and Screenshots.<\/li>\n<li>Documentation: Some housecleaning of filesystem structure of plugin<\/li>\n<\/ul>\n\n<p><strong>Version 1.4<\/strong><\/p>\n\n<ul>\n<li>Bug Fix: Modified to account for <a href=\"http:\/\/codex.wordpress.org\/Child_Themes#How_to_Create_a_Child_Theme\">changed best practice from using @import to function.php<\/a><\/li>\n<\/ul>\n\n<p><strong>Version 1.2<\/strong><\/p>\n\n<ul>\n<li>Bug Fix: Remembers to network enable (activate) the theme after creation.<\/li>\n<li>Feature: Added screenshot support (Thanks! Chris Robinson <a href=\"http:\/\/contempographicdesign.com\/\">http:\/\/contempographicdesign.com\/<\/a>)<\/li>\n<li>Bug Fix: WP_Error handling<\/li>\n<li>Documentation: Refactored codebase<\/li>\n<\/ul>\n\n<p><strong>Version 1.1<\/strong><\/p>\n\n<ul>\n<li>Feature: Added RTL support<\/li>\n<\/ul>\n\n<p><strong>Version 1.0.1<\/strong><\/p>\n\n<ul>\n<li>Commenting changes.<\/li>\n<\/ul>\n\n<p><strong>Version 1.0<\/strong><\/p>\n\n<ul>\n<li>Initial release<\/li>\n<\/ul>","raw_excerpt":"Adds a Theme option to any active theme allowing you to make a child theme.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/482","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=482"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/tychay"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=482"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=482"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=482"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=482"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=482"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=482"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}