Custom Post Data
Post Metadata
To add a meta (stored as a WordPress post meta, here a meta called pdf) to your post data (in a variable called pdf_url):
<?php
// In a PHP file created under your theme's 'php' folder
function add_meta_to_my_app_posts ( $post_data, $post, $component ) {
//Standard WordPress post meta:
$post_data['pdf_url'] = get_post_meta( $post->ID, 'pdf', true );
//Advanced Custom field meta example:
$post_data['my_acf_meta'] = get_field( 'my_acf_meta' ); //Post ID not necessary here
return $post_data ;
}
add_filter( 'wpak_post_data', 'add_meta_to_my_app_posts', 10, 3);
Then, on app side, to display your post meta in your template:
<!-- In single.html or archive.html template -->
<a href="<%= post.my_pdf %>">Download the pdf for <%= post.title %></a>
<!-- If your "my_acf_meta" is an array -->
<ul>
<% _.each( post.my_acf_meta, function( item ) { %>
<li><%= item %></li>
<% } ); %>
</ul>
Post Featured Image Sizes
To add a different image size (like thumbnail) to your post data (in a variable called archive_img):
<?php
// In a PHP file created under your theme's 'php' folder
function add_thumbnail_size( $post_data, $post, $component ) {
$post_featured_img_id = get_post_thumbnail_id( $post->ID );
$post_data['archive_img'] = ''; // Empty default value to be consistent with WP-AppKit 'thumbnail' data
if ( !empty( $post_featured_img_id ) ) {
$featured_img_src = wp_get_attachment_image_src( $post_featured_img_id, 'thumbnail' );
if( !empty( $featured_img_src ) ) {
$post_data['archive_img'] = array(
'src' => $featured_img_src[0],
'width' => $featured_img_src[1],
'height' => $featured_img_src[2],
);
}
}
return $post_data;
}
add_filter( 'wpak_post_data', 'add_thumbnail_size', 10, 3 );
Then you can use this new image format in your archive.html app template: replace post.thumbnail.src by post.archive_img.src.
Taxonomy Terms
To add the terms of a given taxonomy (my_taxonomy) to your post data (in a variable called my_terms):
<?php
// In a PHP file created under your theme's 'php' folder
function add_terms_to_my_app_posts ( $post_data, $post, $component ) {
// Get the post terms
$terms = wp_get_post_terms( $post->ID, 'my_taxonomy' );
// Filter app data (it's better not to include
// every useless WordPress data into the webservice as this will overload it)
$terms_in_app = array();
foreach( $terms as $term ) {
$terms_in_app[] = array( 'slug' => $term->slug, 'name' => $term->name ); // Put here only the data you need
}
$post_data['my_terms'] = $terms_in_app;
return $post_data; // Return the modified $post_data
}
add_filter( 'wpak_post_data', 'add_terms_to_my_app_posts', 10, 3 );
Comments
To add post comments to your post data instead of retrieving them dynamically (in a variable called comments):
<?php
// In a PHP file created under your theme's 'php' folder
function add_comments_to_post( $post_data, $post ) {
$post_data['comments'] = my_get_post_comments( $post->ID );
return $post_data;
}
add_filter( 'wpak_post_data', 'add_comments_to_post', 10, 2 );
function my_get_post_comments( $post_id, $offset = 0 ) {
$query_args = array(
'post_id' => $post_id,
'status' => 'approve',
'number' => 10, // Here I include only 10 comments
'offset' => $offset
);
return get_comments( $query_args );
}
To Know More
- The doc about wpak_post_data filter.
- Our tutorial about how to handle WordPress custom fields (post meta) in your app.
