Reuse fields

documentation/10-containers/10-conditional-display.md

@@ -57,6 +57,8 @@ Container::make( 'post_meta', 'Custom Data' )
     ->add_fields( array( ... ) );
 ```
 
+**Important note:** With [Theme options containers](/docs/containers-theme-options/) only users which have  ``manage_options`` capability have access to the container by default. Therefore ``current_user_role`` / ``current_user_capability`` conditions would not work unless [``carbon_fields_theme_options_container_admin_only_access`` filter](/docs/advanced-topics-hooks)is overridden.  
+
 ##### Nested logic
 
 In order to achieve nested display logic the `where()` and `or_where()` methods also support being invoked with a `callable`:

documentation/40-advanced-topics/70-reuse-fields.md

@@ -0,0 +1,43 @@
+# Reuse Fields
+
+Fields could be reused via functional programming as well as in class declaration.
+
+```php
+     function getLinkGroup($name = 'link') {
+          return Field::make( 'complex', $name )
+              ->add_fields( array(
+                  Field::make( 'text', 'linktext'),
+                  Field::make( 'text', 'url'),
+                  Field::make( 'checkbox', 'newtab' ) )
+              )
+          );
+      }
+
+      function getImageGroup( $name = 'image' ) {
+          return Field::make( 'complex', 'image' )
+              ->add_fields( array(
+                  Field::make( 'image', 'mobile' ),
+                  Field::make( 'image', 'tablet' ),
+                  Field::make( 'image', 'desktop' ) )
+              )
+      }
+
+      function getWysiwyg( $name = 'content' ) {
+          return Field::make( 'rich_text', $name )
+      }
+
+      Container::make( 'post_meta', 'Author Info' )
+          ->where( 'post_type', '=', 'post' )
+          ->add_fields( array(
+              getLinkGroup(),
+              getImageGroup( 'avatar' ),
+              getWysiwyg() )
+      );
+
+      Container::make( 'post_meta', 'Call To Action Button' )
+          ->where( 'post_type', '=', 'page' )
+          ->add_fields( array(
+              getLinkGroup() )
+      );
+   ```
+