acf_export

Acf_export.

Defined (1)

The class is defined in the following location(s).

/core/controllers/export.php  
  1. class acf_export 
  2. { 
  3.      
  4.     var $action; 
  5.      
  6.      
  7.     /** 
  8.     *  __construct 
  9.     * 
  10.     *  @description:  
  11.     *  @since 3.1.8 
  12.     *  @created: 23/06/12 
  13.     */ 
  14.      
  15.     function __construct() 
  16.     { 
  17.         // vars 
  18.         $this->action = ''; 
  19.          
  20.          
  21.         // actions 
  22.         add_action('admin_menu', array($this, 'admin_menu'), 11, 0); 
  23.          
  24.          
  25.         // filters 
  26.         add_filter('acf/export/clean_fields', array($this, 'clean_fields'), 10, 1); 
  27.     } 
  28.      
  29.      
  30.     /** 
  31.     *  admin_menu 
  32.     * 
  33.     *  @description:  
  34.     *  @created: 2/08/12 
  35.     */ 
  36.      
  37.     function admin_menu() 
  38.     { 
  39.         // add page 
  40.         $page = add_submenu_page('edit.php?post_type=acf', __('Export', 'acf'), __('Export', 'acf'), 'manage_options', 'acf-export', array($this, 'html')); 
  41.          
  42.          
  43.         // actions 
  44.         add_action('load-' . $page, array($this, 'load')); 
  45.         add_action('admin_print_scripts-' . $page, array($this, 'admin_print_scripts')); 
  46.         add_action('admin_print_styles-' . $page, array($this, 'admin_print_styles')); 
  47.         add_action('admin_head-' . $page, array($this, 'admin_head')); 
  48.     } 
  49.      
  50.      
  51.     /** 
  52.     *  load 
  53.     * 
  54.     *  @description:  
  55.     *  @since 3.5.2 
  56.     *  @created: 16/11/12 
  57.     *  @thanks: Kevin Biloski and Charlie Eriksen via Secunia SVCRP 
  58.     */ 
  59.      
  60.     function load() 
  61.     { 
  62.         // vars 
  63.         $path = apply_filters('acf/get_info', 'path'); 
  64.          
  65.          
  66.         // verify nonce 
  67.         if( isset($_POST['nonce']) && wp_verify_nonce($_POST['nonce'], 'export') ) 
  68.         { 
  69.             if( isset($_POST['export_to_xml']) ) 
  70.             { 
  71.                 $this->action = 'export_to_xml'; 
  72.             } 
  73.             elseif( isset($_POST['export_to_php']) ) 
  74.             { 
  75.                 $this->action = 'export_to_php'; 
  76.             } 
  77.         } 
  78.          
  79.          
  80.         // include export action 
  81.         if( $this->action == 'export_to_xml' ) 
  82.         { 
  83.             include_once($path . 'core/actions/export.php'); 
  84.             die; 
  85.         } 
  86.     } 
  87.      
  88.      
  89.     /** 
  90.     *  admin_print_scripts 
  91.     * 
  92.     *  @description:  
  93.     *  @since 3.1.8 
  94.     *  @created: 23/06/12 
  95.     */ 
  96.      
  97.     function admin_print_scripts() 
  98.     { 
  99.          
  100.     } 
  101.      
  102.      
  103.     /** 
  104.     *  admin_print_styles 
  105.     * 
  106.     *  @description:  
  107.     *  @since 3.1.8 
  108.     *  @created: 23/06/12 
  109.     */ 
  110.      
  111.     function admin_print_styles() 
  112.     { 
  113.         wp_enqueue_style(array( 
  114.             'wp-pointer',  
  115.             'acf-global',  
  116.             'acf',  
  117.  )); 
  118.     } 
  119.      
  120.      
  121.     /** 
  122.     *  admin_head 
  123.     * 
  124.     *  @description:  
  125.     *  @since 3.1.8 
  126.     *  @created: 23/06/12 
  127.     */ 
  128.      
  129.     function admin_head() 
  130.     { 
  131.                  
  132.     } 
  133.      
  134.      
  135.     /** 
  136.     *  html 
  137.     * 
  138.     *  @description:  
  139.     *  @since 3.1.8 
  140.     *  @created: 23/06/12 
  141.     */ 
  142.      
  143.     function html() 
  144.     {     
  145.         ?> 
  146. <div class="wrap"> 
  147.  
  148.     <div class="icon32" id="icon-acf"><br></div> 
  149.     <h2 style="margin: 4px 0 25px;"><?php _e("Export", 'acf'); ?></h2> 
  150.         <?php 
  151.          
  152.         if( $this->action == "export_to_php" ) 
  153.         { 
  154.             $this->html_php(); 
  155.         } 
  156.         else 
  157.         { 
  158.             $this->html_index(); 
  159.         } 
  160.          
  161.         ?> 
  162. </div> 
  163.         <?php 
  164.          
  165.         return; 
  166.          
  167.     } 
  168.      
  169.      
  170.     /** 
  171.     *  html_index 
  172.     * 
  173.     *  @description:  
  174.     *  @created: 9/08/12 
  175.     */ 
  176.      
  177.     function html_index() 
  178.     { 
  179.         // vars 
  180.         $acfs = get_posts(array( 
  181.             'numberposts' => -1,  
  182.             'post_type' => 'acf',  
  183.             'orderby' => 'menu_order title',  
  184.             'order' => 'asc',  
  185.  )); 
  186.  
  187.         // blank array to hold acfs 
  188.         $choices = array(); 
  189.          
  190.         if($acfs) 
  191.         { 
  192.             foreach($acfs as $acf) 
  193.             { 
  194.                 // find title. Could use get_the_title, but that uses get_post(), so I think this uses less Memory 
  195.                 $title = apply_filters( 'the_title', $acf->post_title, $acf->ID ); 
  196.                  
  197.                 $choices[$acf->ID] = $title; 
  198.             } 
  199.         } 
  200.          
  201.         ?> 
  202. <form method="post"> 
  203. <input type="hidden" name="nonce" value="<?php echo wp_create_nonce( 'export' ); ?>" /> 
  204. <div class="wp-box"> 
  205.     <div class="title"> 
  206.         <h3><?php _e("Export Field Groups", 'acf'); ?></h3> 
  207.     </div> 
  208.     <table class="acf_input widefat"> 
  209.         <tr> 
  210.             <td class="label"> 
  211.                 <label><?php _e("Field Groups", 'acf'); ?></label> 
  212.                 <p class="description"><?php _e("Select the field groups to be exported", 'acf'); ?></p> 
  213.             </td> 
  214.             <td> 
  215.                 <?php do_action('acf/create_field', array( 
  216.                     'type' =>    'select',  
  217.                     'name' =>    'acf_posts',  
  218.                     'value' =>    '',  
  219.                     'choices' =>    $choices,  
  220.                     'multiple' =>    1,  
  221.  )); ?> 
  222.             </td> 
  223.         </tr> 
  224.         <tr> 
  225.             <td class="label"></td> 
  226.             <td> 
  227.                 <ul class="hl clearfix"> 
  228.                     <li> 
  229.                         <input type="submit" class="acf-button" name="export_to_xml" value="<?php _e("Export to XML", 'acf'); ?>" /> 
  230.                     </li> 
  231.                     <li> 
  232.                         <input type="submit" class="acf-button" name="export_to_php" value="<?php _e("Export to PHP", 'acf'); ?>" /> 
  233.                     </li> 
  234.                 </ul> 
  235.             </td> 
  236.         </tr> 
  237.     </table> 
  238. </div> 
  239. </form> 
  240.  
  241. <p><br /></p> 
  242. <h3><?php _e("Export to XML", 'acf'); ?></h3> 
  243. <p><?php _e("ACF will create a .xml export file which is compatible with the native WP import plugin.", 'acf'); ?></p> 
  244. <p><?php _e("Imported field groups <b>will</b> appear in the list of editable field groups. This is useful for migrating fields groups between Wp websites.", 'acf'); ?></p> 
  245. <ol> 
  246.     <li><?php _e("Select field group(s) from the list and click \"Export XML\"", 'acf'); ?></li> 
  247.     <li><?php _e("Save the .xml file when prompted", 'acf'); ?></li> 
  248.     <li><?php _e("Navigate to Tools » Import and select WordPress", 'acf'); ?></li> 
  249.     <li><?php _e("Install WP import plugin if prompted", 'acf'); ?></li> 
  250.     <li><?php _e("Upload and import your exported .xml file", 'acf'); ?></li> 
  251.     <li><?php _e("Select your user and ignore Import Attachments", 'acf'); ?></li> 
  252.     <li><?php _e("That's it! Happy WordPressing", 'acf'); ?></li> 
  253. </ol> 
  254.  
  255. <p><br /></p> 
  256.  
  257. <h3><?php _e("Export to PHP", 'acf'); ?></h3> 
  258. <p><?php _e("ACF will create the PHP code to include in your theme.", 'acf'); ?></p> 
  259. <p><?php _e("Registered field groups <b>will not</b> appear in the list of editable field groups. This is useful for including fields in themes.", 'acf'); ?></p> 
  260. <p><?php _e("Please note that if you export and register field groups within the same WP, you will see duplicate fields on your edit screens. To fix this, please move the original field group to the trash or remove the code from your functions.php file.", 'acf'); ?></p> 
  261. <ol> 
  262.     <li><?php _e("Select field group(s) from the list and click \"Create PHP\"", 'acf'); ?></li> 
  263.     <li><?php _e("Copy the PHP code generated", 'acf'); ?></li> 
  264.     <li><?php _e("Paste into your functions.php file", 'acf'); ?></li> 
  265.     <li><?php _e("To activate any Add-ons, edit and use the code in the first few lines.", 'acf'); ?></li> 
  266. </ol> 
  267. <?php 
  268.  
  269.     } 
  270.      
  271.      
  272.     /** 
  273.     *  html_php 
  274.     * 
  275.     *  @description:  
  276.     *  @created: 9/08/12 
  277.     */ 
  278.      
  279.     function html_php() 
  280.     { 
  281.          
  282.         ?> 
  283. <div class="wp-box"> 
  284.     <div class="title"> 
  285.         <h3><?php _e("Export Field Groups to PHP", 'acf'); ?></h3> 
  286.     </div> 
  287.     <table class="acf_input widefat"> 
  288.         <tr> 
  289.             <td class="label"> 
  290. <h3><?php _e("Instructions", 'acf'); ?></h3> 
  291. <ol> 
  292.     <li><?php _e("Copy the PHP code generated", 'acf'); ?></li> 
  293.     <li><?php _e("Paste into your functions.php file", 'acf'); ?></li> 
  294.     <li><?php _e("To activate any Add-ons, edit and use the code in the first few lines.", 'acf'); ?></li> 
  295. </ol> 
  296.  
  297. <p><br /></p> 
  298.  
  299. <h3><?php _e("Notes", 'acf'); ?></h3> 
  300. <p><?php _e("Registered field groups <b>will not</b> appear in the list of editable field groups. This is useful for including fields in themes.", 'acf'); ?></p> 
  301. <p><?php _e("Please note that if you export and register field groups within the same WP, you will see duplicate fields on your edit screens. To fix this, please move the original field group to the trash or remove the code from your functions.php file.", 'acf'); ?></p> 
  302.  
  303.  
  304. <p><br /></p> 
  305.  
  306. <h3><?php _e("Include in theme", 'acf'); ?></h3> 
  307. <p><?php _e("The Advanced Custom Fields plugin can be included within a theme. To do so, move the ACF plugin inside your theme and add the following code to your functions.php file:", 'acf'); ?></p> 
  308.  
  309. <pre> 
  310. include_once('advanced-custom-fields/acf.php'); 
  311. </pre> 
  312.  
  313. <p><?php _e("To remove all visual interfaces from the ACF plugin, you can use a constant to enable lite mode. Add the following code to your functions.php file <b>before</b> the include_once code:", 'acf'); ?></p> 
  314.  
  315. <pre> 
  316. define( 'ACF_LITE', true ); 
  317. </pre> 
  318.   
  319. <p><br /></p> 
  320.  
  321. <p><a href="">« <?php _e("Back to export", 'acf'); ?></a></p> 
  322.             </td> 
  323.             <td> 
  324.                 <textarea class="pre" readonly="true"><?php 
  325.          
  326.         $acfs = array(); 
  327.          
  328.         if( isset($_POST['acf_posts']) ) 
  329.         { 
  330.             $acfs = get_posts(array( 
  331.                 'numberposts' => -1,  
  332.                 'post_type' => 'acf',  
  333.                 'orderby' => 'menu_order title',  
  334.                 'order' => 'asc',  
  335.                 'include' =>    $_POST['acf_posts'],  
  336.                 'suppress_filters' => false,  
  337.  )); 
  338.         } 
  339.         if( $acfs ) 
  340.         { 
  341.             ?> 
  342. if(function_exists("register_field_group")) 
  343. { 
  344. <?php 
  345.             foreach( $acfs as $i => $acf ) 
  346.             { 
  347.                 // populate acfs 
  348.                 $var = array( 
  349.                     'id' => $acf->post_name,  
  350.                     'title' => $acf->post_title,  
  351.                     'fields' => apply_filters('acf/field_group/get_fields', array(), $acf->ID),  
  352.                     'location' => apply_filters('acf/field_group/get_location', array(), $acf->ID),  
  353.                     'options' => apply_filters('acf/field_group/get_options', array(), $acf->ID),  
  354.                     'menu_order' => $acf->menu_order,  
  355.  ); 
  356.                  
  357.                  
  358.                 $var['fields'] = apply_filters('acf/export/clean_fields', $var['fields']); 
  359.  
  360.  
  361.                 // create html 
  362.                 $html = var_export($var, true); 
  363.                  
  364.                 // change double spaces to tabs 
  365.                 $html = str_replace("  ", "\t", $html); 
  366.                  
  367.                 // correctly formats "=> array(" 
  368.                 $html = preg_replace('/([\t\r\n]+?)array/', 'array', $html); 
  369.                  
  370.                 // Remove number keys from array 
  371.                 $html = preg_replace('/[0-9]+ => array/', 'array', $html); 
  372.                  
  373.                 // add extra tab at start of each line 
  374.                 $html = str_replace("\n", "\n\t", $html); 
  375.                  
  376.                 // add the WP __() function to specific strings for translation in theme 
  377.                 //$html = preg_replace("/'label'(.*?)('.*?')/", "'label'$1__($2)", $html); 
  378.                 //$html = preg_replace("/'instructions'(.*?)('.*?')/", "'instructions'$1__($2)", $html); 
  379.                  
  380.                                  
  381. ?>    register_field_group(<?php echo $html ?>); 
  382. <?php 
  383.             } 
  384. ?> 
  385. } 
  386. <?php 
  387.         } 
  388.         else 
  389.         { 
  390.             _e("No field groups were selected", 'acf'); 
  391.         } 
  392.                 ?></textarea> 
  393.             </td> 
  394.         </tr> 
  395.     </table> 
  396. </div> 
  397. <script type="text/javascript"> 
  398. (function($) { 
  399.      
  400.     var i = 0; 
  401.      
  402.     $(document).on('click', 'textarea.pre', function() { 
  403.          
  404.         if( i == 0 ) 
  405.         { 
  406.             i++; 
  407.              
  408.             $(this).focus().select(); 
  409.              
  410.             return false; 
  411.         } 
  412.                  
  413.     }); 
  414.      
  415.     $(document).on('keyup', 'textarea.pre', function() { 
  416.      
  417.         $(this).height( 0 ); 
  418.         $(this).height( this.scrollHeight ); 
  419.      
  420.     }); 
  421.  
  422.     $(document).ready(function() { 
  423.          
  424.         $('textarea.pre').trigger('keyup'); 
  425.  
  426.     }); 
  427.  
  428. })(jQuery); 
  429. </script> 
  430.     <?php 
  431.     } 
  432.      
  433.      
  434.     /** 
  435.     *  clean_fields 
  436.     * 
  437.     *  @description:  
  438.     *  @since: 3.5.7 
  439.     *  @created: 7/03/13 
  440.     */ 
  441.      
  442.     function clean_fields( $fields ) 
  443.     { 
  444.         // trim down the fields 
  445.         if( $fields ) 
  446.         { 
  447.             foreach( $fields as $i => $field ) 
  448.             { 
  449.                 // unset unneccessary bits 
  450.                 unset( $field['id'], $field['class'], $field['order_no'], $field['field_group'], $field['_name'] ); 
  451.                  
  452.                  
  453.                 // instructions 
  454.                 if( !$field['instructions'] ) 
  455.                 { 
  456.                     unset( $field['instructions'] ); 
  457.                 } 
  458.                  
  459.                  
  460.                 // Required 
  461.                 if( !$field['required'] ) 
  462.                 { 
  463.                     unset( $field['required'] ); 
  464.                 } 
  465.                  
  466.                  
  467.                 // conditional logic 
  468.                 if( !$field['conditional_logic']['status'] ) 
  469.                 { 
  470.                     unset( $field['conditional_logic'] ); 
  471.                 } 
  472.                  
  473.                  
  474.                 // children 
  475.                 if( isset($field['sub_fields']) ) 
  476.                 { 
  477.                     $field['sub_fields'] = apply_filters('acf/export/clean_fields', $field['sub_fields']); 
  478.                 } 
  479.                 elseif( isset($field['layouts']) ) 
  480.                 { 
  481.                     foreach( $field['layouts'] as $l => $layout ) 
  482.                     { 
  483.                         $field['layouts'][ $l ]['sub_fields'] = apply_filters('acf/export/clean_fields', $layout['sub_fields']); 
  484.                     } 
  485.                 } 
  486.  
  487.                  
  488.                 // override field 
  489.                 $fields[ $i ] = $field; 
  490.             } 
  491.         } 
  492.          
  493.         return $fields; 
  494.     }     
  495. }