Customizer Export\/Import<\/a> plugin (the customizer settings will be imported only if the export file was created from the same theme).<\/p>\n\nThis plugin is based off the 'One Click Demo Import' plugin by @capuderg and @cyman, https:\/\/github.com\/proteusthemes\/one-click-demo-import.<\/p>\n\n
As well as the improved WP Import 2.0 plugin by @humanmade, https:\/\/github.com\/humanmade\/WordPress-Importer.<\/p>\n\n
License<\/h3>\n\n
Theme Demo Import uses 'One Click Demo Import' plugin script\nhttps:\/\/github.com\/proteusthemes\/one-click-demo-import\n(C) 2016 ProteusThemes.com\nLicensed under the GNU General Public License v2.0,\nhttp:\/\/www.gnu.org\/licenses\/gpl-2.0.html<\/p>\n\n
Theme Demo Import uses 'Wordpress Importer' plugin script\nhttps:\/\/github.com\/humanmade\/WordPress-Importer\n(C) 2016 @humanmade\nLicensed under the GNU General Public License v2.0,\nhttp:\/\/www.gnu.org\/licenses\/gpl-2.0.html<\/p>\n\n
Copyright<\/h3>\n\n
Theme Demo Import, Copyright 2016 Ishmael 'Hans' Desjarlais<\/p>\n\n
Theme Demo Import is distributed under the terms of the GNU GPL<\/p>\n\n
This program is free software; you can redistribute it and\/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation; either version 2 of the License, or\n(at your option) any later version.<\/p>\n\n
This program is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\nGNU General Public License for more details.<\/p>\n\n
You should have received a copy of the GNU General Public License along\nwith this program; if not, write to the Free Software Foundation, Inc.,\n51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.<\/p>\n\n\n
From your WordPress dashboard<\/strong><\/p>\n\n\n- Visit 'Plugins > Add New',<\/li>\n
- Search for 'Theme Demo Import' and install the plugin.<\/li>\n
- Activate 'Theme Demo Import' from your Plugins page.<\/li>\n<\/ol>\n\n
Once the plugin is activated you will find the actual import page in Appearance -> Import Demo Content.<\/strong><\/p>\n\n\n\nI have activated the plugin. Where is the \"Import Demo Content\" page?<\/h3><\/dt>\nYou will find the import page in wp-admin -> Appearance -> Import Demo Content<\/em>.<\/p><\/dd>\nWhere are the demo import files and the log files saved?<\/h3><\/dt>\nThe files used in the demo import will be saved to the default WordPress uploads directory. An example of that directory would be: ..\/wp-content\/uploads\/2016\/03\/<\/code>.<\/p>\n\nThe log file will also be registered in the wp-admin -> Media<\/em> section, so you can access it easily.<\/p><\/dd>\nHow to predefine demo imports?<\/h3><\/dt>\nThis question is for theme authors. To predefine demo imports, you just have to add the following code structure, with your own values to your theme (using the theme-demo-import\/import_files<\/code> filter):<\/p>\n\nfunction TDI_import_files() {\n return array(\n array(\n 'import_file_name' => 'Demo Import 1',\n 'import_file_url' => 'http:\/\/www.your_domain.com\/tdi\/demo-content.xml',\n 'import_widget_file_url' => 'http:\/\/www.your_domain.com\/tdi\/widgets.json',\n 'import_customizer_file_url' => 'http:\/\/www.your_domain.com\/tdi\/customizer.dat',\n 'import_preview_image_url' => 'http:\/\/www.your_domain.com\/tdi\/preview_import_image1.jpg',\n 'import_notice' => __( 'After you import this demo, you will have to setup the slider separately.', 'your-textdomain' ),\n ),\n array(\n 'import_file_name' => 'Demo Import 2',\n 'import_file_url' => 'http:\/\/www.your_domain.com\/tdi\/demo-content2.xml',\n 'import_widget_file_url' => 'http:\/\/www.your_domain.com\/tdi\/widgets2.json',\n 'import_customizer_file_url' => 'http:\/\/www.your_domain.com\/tdi\/customizer2.dat',\n 'import_preview_image_url' => 'http:\/\/www.your_domain.com\/tdi\/preview_import_image2.jpg',\n 'import_notice' => __( 'A special note for this import.', 'your-textdomain' ),\n ),\n );\n}\nadd_filter( 'theme-demo-import\/import_files', 'TDI_import_files' );\n<\/code><\/pre>\n\nYou can set content import, widgets, and customizer import files. You can also define a preview image, which will be used only when multiple demo imports are defined, so that the user will see the difference between imports.<\/p><\/dd>\n
How to automatically assign \"Front page\", \"Posts page\" and menu locations after the importer is done?<\/h3><\/dt>\nYou can do that, with the theme-demo-import\/after_import<\/code> action hook. The code would look something like this:<\/p>\n\nfunction TDI_after_import_setup() {\n \/\/ Assign menus to their locations.\n $main_menu = get_term_by( 'name', 'Top Menu', 'nav_menu' );\n\n set_theme_mod( 'nav_menu_locations', array(\n 'primary-menu' => $main_menu->term_id,\n )\n );\n\n \/\/ Assign front page and posts page (blog page).\n $front_page_id = get_page_by_title( 'Home' );\n $blog_page_id = get_page_by_title( 'Blog' );\n\n update_option( 'show_on_front', 'page' );\n update_option( 'page_on_front', $front_page_id->ID );\n update_option( 'page_for_posts', $blog_page_id->ID );\n\n}\nadd_action( 'theme-demo-import\/after_import', 'TDI_after_import_setup' );\n<\/code><\/pre><\/dd>\nWhat about using local import files (from theme folder)?<\/h3><\/dt>\nYou have to use the same filter as in above example, but with a slightly different array keys: local_*<\/code>. The values have to be absolute paths (not URLs) to your import files. To use local import files, that reside in your theme folder, please use the below code. Note: make sure your import files are readable!<\/p>\n\nfunction TDI_import_files() {\n return array(\n array(\n 'import_file_name' => 'Demo Import 1',\n 'local_import_file' => trailingslashit( get_template_directory() ) . 'tdi\/demo-content.xml',\n 'local_import_widget_file' => trailingslashit( get_template_directory() ) . 'tdi\/widgets.json',\n 'local_import_customizer_file' => trailingslashit( get_template_directory() ) . 'tdi\/customizer.dat',\n 'import_preview_image_url' => 'http:\/\/www.your_domain.com\/tdi\/preview_import_image1.jpg',\n 'import_notice' => __( 'After you import this demo, you will have to setup the slider separately.', 'your-textdomain' ),\n ),\n array(\n 'import_file_name' => 'Demo Import 2',\n 'local_import_file' => trailingslashit( get_template_directory() ) . 'tdi\/demo-content2.xml',\n 'local_import_widget_file' => trailingslashit( get_template_directory() ) . 'tdi\/widgets2.json',\n 'local_import_customizer_file' => trailingslashit( get_template_directory() ) . 'tdi\/customizer2.dat',\n 'import_preview_image_url' => 'http:\/\/www.your_domain.com\/tdi\/preview_import_image2.jpg',\n 'import_notice' => __( 'A special note for this import.', 'your-textdomain' ),\n ),\n );\n}\nadd_filter( 'theme-demo-import\/import_files', 'TDI_import_files' );\n<\/code><\/pre><\/dd>\nHow to handle different \"after import setups\" depending on which predefined import was selected?<\/h3><\/dt>\nThis question might be asked by a theme author wanting to implement different after import setups for multiple predefined demo imports. Lets say we have predefined two demo imports with the following names: 'Demo Import 1' and 'Demo Import 2', the code for after import setup would be (using the theme-demo-import\/after_import<\/code> filter):<\/p>\n\nfunction TDI_after_import( $selected_import ) {\n echo \"This will be displayed on all after imports!\";\n\n if ( 'Demo Import 1' === $selected_import['import_file_name'] ) {\n echo \"This will be displayed only on after import if user selects Demo Import 1\";\n\n \/\/ Set logo in customizer\n set_theme_mod( 'logo_img', get_template_directory_uri() . '\/assets\/images\/logo1.png' );\n }\n elseif ( 'Demo Import 2' === $selected_import['import_file_name'] ) {\n echo \"This will be displayed only on after import if user selects Demo Import 2\";\n\n \/\/ Set logo in customizer\n set_theme_mod( 'logo_img', get_template_directory_uri() . '\/assets\/images\/logo2.png' );\n }\n}\nadd_action( 'theme-demo-import\/after_import', 'TDI_after_import' );\n<\/code><\/pre><\/dd>\nCan I add some code before the widgets get imported?<\/h3><\/dt>\nOf course you can, use the theme-demo-import\/before_widgets_import<\/code> action. You can also target different predefined demo imports like in the example above. Here is a simple example code of the theme-demo-import\/before_widgets_import<\/code> action:<\/p>\n\nfunction TDI_before_widgets_import( $selected_import ) {\n echo \"Add your code here that will be executed before the widgets get imported!\";\n}\nadd_action( 'theme-demo-import\/before_widgets_import', 'TDI_before_widgets_import' );\n<\/code><\/pre><\/dd>\nI'm a theme author and I want to change the plugin intro text, how can I do that?<\/h3><\/dt>\nYou can change the plugin intro text by using the theme-demo-import\/plugin_intro_text<\/code> filter:<\/p>\n\nfunction TDI_plugin_intro_text( $default_text ) {\n $default_text .= '<div class=\"TDI__intro-text\">This is a custom text added to this plugin intro text.<\/div>';\n\n return $default_text;\n}\nadd_filter( 'theme-demo-import\/plugin_intro_text', 'TDI_plugin_intro_text' );\n<\/code><\/pre>\n\nTo add some text in a separate \"box\", you should wrap your text in a div with a class of 'TDI__intro-text', like in the code example above.<\/p><\/dd>\n
How to disable generation of smaller images (thumbnails) during the content import<\/h3><\/dt>\nThis will greatly improve the time needed to import the content (images), but only the original sized images will be imported. You can disable it with a filter, so just add this code to your theme function.php file:<\/p>\n\n
add_filter( 'theme-demo-import\/regenerate_thumbnails_in_content_import', '__return_false' );\n<\/code><\/pre><\/dd>\nHow to change the location, title and other parameters of the plugin page?<\/h3><\/dt>\nAs a theme author you do not like the location of the \"Import Demo Content\" plugin page in Appearance -> Import Demo Content<\/em>? You can change that with the filter below. Apart from the location, you can also change the title or the page\/menu and some other parameters as well.<\/p>\n\nfunction TDI_plugin_page_setup( $default_settings ) {\n $default_settings['parent_slug'] = 'themes.php';\n $default_settings['page_title'] = esc_html__( 'Theme Demo Import' , 'theme-demo-import' );\n $default_settings['menu_title'] = esc_html__( 'Import Demo Content' , 'theme-demo-import' );\n $default_settings['capability'] = 'import';\n $default_settings['menu_slug'] = 'theme-demo-import';\n\n return $default_settings;\n}\nadd_filter( 'theme-demo-import\/plugin_page_setup', 'TDI_plugin_page_setup' );\n<\/code><\/pre><\/dd>\nI can't activate the plugin, because of a fatal error, what can I do?<\/h3><\/dt>\nUpdate: There is now a admin error notice, stating that the minimal PHP version required for this plugin is 5.3.2.<\/em><\/p>\n\nYou want to activate the plugin, but this error shows up:<\/p>\n\n
Plugin could not be activated because it triggered a fatal error<\/em><\/p>\n\nThis happens, because your hosting server is using a very old version of PHP. This plugin requires PHP version of at least 5.3.x<\/strong>, but we recommend version 5.6.x<\/em>. Please contact your hosting company and ask them to update the PHP version for your site.<\/p><\/dd>\n\n<\/dl>\n\n\n1.1.1 - November 2nd, 2022<\/strong><\/p>\n\n\n- SECURITY FIX: Prevent uploading PHP files<\/li>\n<\/ul>\n\n
1.0.5 - March 29, 2019<\/strong><\/p>\n\n\n- Removed extra $ on line 72 of class-tdi-helpers.php which was triggering a PHP 7.0+ error<\/li>\n<\/ul>\n\n
1.0.2 - 10\/25\/2016<\/strong><\/p>\n\n\n- Removed dependencies on 3rd party plugin<\/li>\n
- Renamed classes for HM files<\/li>\n
- Added license and copyright information to readme.txt file<\/li>\n
- Updated the plugin description<\/li>\n<\/ul>\n\n
1.0.1 - 10\/15\/2016<\/strong><\/p>\n\n\n- Updated text strings<\/li>\n
- Updated styles (UI)<\/li>\n
- Removed unnecessary code<\/li>\n<\/ul>\n\n
1.0.0 - 10\/10\/2016<\/strong><\/p>\n\n\n- INITIAL RELEASE<\/li>\n<\/ul>\n\n
1.1.2 - 06\/24\/2024<\/strong><\/p>\n\n\n- Added stricter accept attributes in file upload inputs in \/inc\/class-tdi-main.php (lines 155, 160 and 165)<\/li>\n
- Added pattern attribute to file upload inputs in \/inc\/class-tdi-main.php (lines 155, 160 and 165)<\/li>\n<\/ul>\n\n
1.1.3 - 07\/3\/2024<\/strong>\n- Security: Improved file upload validation for widget imports.\n- Security: Added server-side checks for file types, MIME types, and file sizes.\n- Enhancement: Improved error handling and logging in AJAX file uploads.\n- Enhancement: Added more detailed console logging for easier debugging.\n- Performance: Optimized AJAX handling for smoother file uploads.<\/p>","raw_excerpt":"Quickly import demo content, widgets and settings in one click. Made for theme authors to simplify importing demo content for their users.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/51776","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=51776"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/themely"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=51776"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=51776"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=51776"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=51776"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=51776"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=51776"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}