Simple Yearly Archive

add_filter( 'sya_the_title', 'my_sya_filter_title', 10, 2 );

function my_sya_filter_title( $title, $id ) {
return $id . ' - ' . $title;
}

add_filter( 'sya_postlink', 'sya_modify_postlinks', 10, 3 );

function sya_modify_postlinks( $link_html, $post ) {
$dom = new DOMDocument();
$dom->loadHtml($link_html);
$xpath = new DOMXPath($dom);
$link = $xpath->query("//a")->item(0);
$link_classes = explode(' ', $link->getAttribute('class'));
$link_classes[] = 'postyear-' . $post->post_year;
$link->setAttribute('class', implode(' ', $link_classes));
return $dom->saveHTML();
}

This will add a CSS class with the post year to the post links.
How can I change the posts' authors listing (like in supporting the Co-Authors Plus plugin)?
Just use the filter sya_the_authors. Example: Add the following to your theme's functions.php:

if( function_exists('get_coauthors') ) {
add_filter( 'sya_the_authors', 'my_sya_filter_authors', 10, 2 );

function my_sya_filter_authors( $author, $post ) {
$coauthors = get_coauthors( $post->ID );
$authorsCollection = array();
foreach( $coauthors as $coauthor ) {
if( $coauthor->display_name ) {
$authorsCollection[] = $coauthor->display_name;
}
}
return implode(', ', $authorsCollection);
}
}

How can I make the posts' categories list only show child categories?
Just use the filter sya_categories. Example: Add the following to your theme's functions.php:

function sya_child_categories( $sya_categories ) {
return array_filter($sya_categories, function($v, $k) {
return get_category( $k )->parent > 0;
}, ARRAY_FILTER_USE_BOTH);
}
add_filter( 'sya_categories', 'sya_child_categories', 10, 3 );

How can I change query parameters?
Just use the filter sya_get_posts that allows you to query for literally anything using WP_Query parameters. Add the following snippets to your theme's functions.php.

Display posts that have "either" of these tags

add_filter( 'sya_get_posts', function() {
return array(
'tag' => 'bread,baking'
);
});

Display posts that match the search term "keyword"

add_filter( 'sya_get_posts', function() {
return array(
's' => 'keyword'
);
});

Display only password protected posts

add_filter( 'sya_get_posts', function() {
return array(
'has_password' => true
);
});

Display only 10 posts

add_filter( 'sya_get_posts', function() {
return array(
'numberposts' => 10
);
});

Display posts tagged with bob, under people custom taxonomy

add_filter( 'sya_get_posts', function() {
return array(
'tax_query' => array(
array(
'taxonomy' => 'people',
'field' => 'slug',
'terms' => 'bob',
)
)
);
});

Display posts from several custom taxonomies

add_filter( 'sya_get_posts', function() {
return array(
'tax_query' => array(
'relation' => 'AND',
array(
'taxonomy' => 'movie_genre',
'field' => 'slug',
'terms' => array( 'action', 'comedy' ),
),
array(
'taxonomy' => 'actor',
'field' => 'term_id',
'terms' => array( 103, 115, 206 ),
'operator' => 'NOT IN',
),
)
);
});

Display posts that are in the quotes category OR have the quote format

add_filter( 'sya_get_posts', function() {
return array(
'tax_query' => array(
'relation' => 'OR',
array(
'taxonomy' => 'category',
'field' => 'slug',
'terms' => array( 'quotes' ),
),
array(
'taxonomy' => 'post_format',
'field' => 'slug',
'terms' => array( 'post-format-quote' ),
),
)
);
});

Display posts that are in the quotes category OR both have the quote post format AND are in the wisdom category

add_filter( 'sya_get_posts', function() {
return array(
'tax_query' => array(
'relation' => 'OR',
array(
'taxonomy' => 'category',
'field' => 'slug',
'terms' => array( 'quotes' )
),
array(
'relation' => 'AND',
array(
'taxonomy' => 'post_format',
'field' => 'slug',
'terms' => array( 'post-format-quote' )
),
array(
'taxonomy' => 'category',
'field' => 'slug',
'terms' => array( 'wisdom' ),
)
)
)
);
});

Configuration? Parameters? Head over here