Posts in Sidebar 4.0 is available

I just released a new version of Posts in Sidebar plugin and it’s live on the WordPress repository just now. After 3 weeks from the last release, a new version brings new capabilities in using the power of WordPress for retrieving your posts. These are the new items from the changelog:

  1. Added section for retrieving posts from multiple custom fields. Until now you were able to get posts with a single custom field and/or value. Now you can put in relation multiple custom fields, as per WP_Query capability.
  2. Added option for retrieving posts with/without password. This is a totally new option, and you can get posts that have a password, or posts that haven’t a password, or posts either with password and without a password (i.e. all posts), as per WP_Query capability.
  3. Added option for retrieving posts with a certain password. You can get posts with a certain password. The previous options is not related with this field, so it’s enough you enter directly a password and WordPress will give you posts that have that password, as per WP_Query capability.
  4. Now panels do not collapse after saving the widget. This is a long waited enhancement for the UI of the plugin. As you know, when you save the widget after having opened a lot of panels, the panels get closed after the refresh. Now the panels remain in the state they were before pressing the Save button.

If you like this plugin, do not forget to leave a review and, if you can, make a donation. This would be very appreciated. :)

Private Content plugin and custom roles

A short post to explain how to use custom roles with Private Content plugin.

As you already know, my Private Content Plugin works fine with WordPress built-in standard roles. Sometimes a user asks for more informations on how the plugin works with custom roles. Let’s see that in this post.

Continue reading “Private Content plugin and custom roles”

How Posts in Sidebar chooses the main category of the post

A technical blog post on the new feature “Sort categories” in the Posts in Sidebar plugin.

One of the features of my plugin Posts in Sidebar is that the widget, when viewing a single post page (i.e. a blog post page), can display a content different from the standard. For example, a user could want to display a list of recent posts in the main widget but, when viewing a single post page, a list of posts published under the same category of the main post. The feature is available under Getting posts > Change the query when on single posts.

In a recent release of my plugin Posts in Sidebar (exactly the 3.8.4 version) I made an important change regarding which category to use in order to get the posts, when a post has multiple categories. In the previous versions the plugin picked up the category with the lowest letter in the alphabetically sorted list of the post’s categories and used it to get the posts. Starting from 3.8.4 the plugin can use the category with the lowest ID, that is the WordPress-style to choose the category for the permalink construction. Let’s see something more detailed on this.

Continue reading “How Posts in Sidebar chooses the main category of the post”

Posts in Sidebar 1.19

Yesterday I released Posts in Sidebar 1.19 that contains a requested change. Before 1.19 you have had a dropdown menu in order to select the category or the tag but, if you had a large number of terms, the page would take a lot of time to load.

Some of the users of this plugin asked me to change this. The change has come and now categories and tags will be chosen using a simple text field, where you have to enter the IDs or the slugs of the terms, in the way I’ll explain here.

Posts retrieving

post-retrieving

In the “Posts retrieving” section the categories and tags are now chosen manually by entering their respective slugs (i.e., the short form generated by WordPress). To find these slugs, go to the categories/tags management and search there for the terms.

Obviously, this is not as simple as before, but it’s necessary in order to avoid slow page loading.

A benefit of this change is that now you can retrieve posts from multiple terms. Before 1.19 you got posts from one category and/or one tag, now you can get posts from multiple categories and multiple tags (for example, posts that are in “Category 1” or in “Category 2” or in “Category 3”, and so on). In order to do that, simply enter the slugs separated by comma, for example:

news,asides,quotes

Also, you can get posts that are under two or more categories at the same time. In order to do that, simply use a + (a plus) between terms, for example:

news+asides+quotes

This was not possible before 1.19.

Posts exclusion

post-exclusion

In the posts exclusion section, I removed the two forms and added two simple text fields. In this case you will not use the slugs of the terms but their IDs. In order to easily find the IDs of the terms, install a plugin like Reveal IDs: this plugin will add a column in the page management of terms.

Even in this section of the widget, you can use a comma to separate each term or a plus sign, as described before.

Glitches

After updating the plugin, it’s better to take a look at the widget of Posts in Sidebar and make sure all is OK. If all seems to be right, save the widget anyway.

In fact, in this version change, you could encounter a couple of “issues”, that can be easily resolved:

  1. If in the previous version you didn’t specify a category or a tag in the “Post retrieving” section, after updating you will find a “NULL” value. Simply delete this value and save the widget.
  2. If in the previous version you specified a category or a tag in the “Post exclusion” section, simply save the widget.

For any question or help, please use the WordPress forum.

New features in Posts in Sidebar

This is a Saturday of updates! After having released v.2.2 of Private Content plugin, now I’m proud to introduce you the just-cooked 1.8 version of Posts in Sidebar. Just last week I released the v1.7 with important new features like the possibility to show not only posts but also pages and custom post types. This week you’ll get the last missing features and this is the changelog for the new v1.8 of Posts in Sidebar:

  1. New: added post format as option to get posts.
  2. New: added option for link to custom post type archive.
  3. New: added option for link to post format archive.
  4. Other minor changes.

Only one function is now missing: grab posts using custom taxonomies. Hope to finish this work soon.

Enjoy! :)

Private content reaches v2.2

One of the frequently asked questions the users of my plugin Private Content do is the following:

Is there a way to display an alternate text to readers that haven’t the rights to read the hidden text

I’ve always answered that this plugin was designed to show only a simple note to the subscribers/collaborators, leaving other members/visitors out of any type of message. But often a developer can’t imagine all the possible usages a piece of software can encounter. This plugin, clearly, is used not only to display private notes/messages to some people, but also to display an alternative text if these readers haven’t the rights to read that note/message.

I’ve been always opposed to add this feature, but today I added it to Private Content. So, if you asked for it, update the plugin to version 2.2.

Usage

As usual write the to-be-hidden sentence wrapped into the shortcode, but add option alt, for example:

[private role="author" alt="Sorry, but you have not rights to read this."]Secret text for authors[/private]

In this way Authors (and higher members, like Editors and Amministrators) will read this, while lower members will read only Sorry, but you have not rights to read this.

Enjoy!

Posts in Sidebar 1.7

New 1.7 version of the Posts in Sidebar plugin.

The Posts in Sidebar plugin has just been updated to version 1.7 and now it sports a series of changes. From day to day I receive requests both in the forum and via email from users who launch their idea. I think this is a very good thing for developers. The plugin is constantly evolving, also thanks to these suggestions.

The new version has this changelog:

  1. The plugin now can display not only posts, but also pages and custom post types.
  2. Now the author of the post can be displayed next to the date and comments.
  3. The content of the posts can now be displayed as Full content, meaning that the post is displayed as in a single post page (useful for a video-only posts, for example).
  4. The link at the end of the excerpt can now be displayed as Read more… (or whatever the user wants).
  5. Added French translation, thanks to Thérèse Lachance.

Many other changes have been done. What remains to do is:

  1. retrieve posts via posts format;
  2. retrieve posts via custom taxonomies.

I hope to have the time to do that. :)

Private content 2.1

A new version of my Private Content plugin has just been released! The new 2.1 version lets you show a note only to visitors and hide it to other users. So the shortcode now accepts this role:

[private role="visitor-only"]Text for Visitors only[/private]

As you probably know, there isn’t a role for Visitors. So, to accomplish this, the plugin makes a check if the user is logged in: if not, the note will be displayed and hidden to other logged-in users (Subscribers, Authors, and so on). Here the new code:

case 'visitor-only' :
    if ( ! is_user_logged_in() )
        $text = '<p class="private visitor-content visitor-only"' . $align_style . '>' . $content . '</p>';
    break;

As usual, the p element has an its own class, so you can stylize it as you like via CSS.

This new feature has been added thanks to Jacki, a reader of my Italian blog, who left a comment with this new idea.

Delicious Readings plugin goes 2.0

Yesterday I pushed to the WordPress repository a new version of my plugin Delicious Readings. If you don’t know this plugin, Delicious Readings lets you publish on your blog a collection of Delicious bookmarks stored with a particular tagged of your choice. So, for example, you can publish your bookmarks stored under “readings” or “pets” or “sushi” and so on.

The new version 2.0 adds the shortcode, in order to publish this list on a page or on a post. The idea comes from a user on the WordPress forums, who asked if there were the possibility to publish this list on a page rather than on a widget in the sidebar (already full of stuff). I was replying that he could call the plugin’s main function directly in the PHP code, but I thought it were better to add a shortcode for use in the writing panel.

Usage as shortcode

The shortcode accepts the full range of options of the core function. The only mandatory option is the address of the feed. So, for example, if your username is joe and the tag is books the shortcode will be:

[dreadings feed_url="http://delicious.com/v2/rss/joe/books"]

The plugin will show the last 5 bookmarks by default. If you want to show 10 bookmarks, change the shortcode as follows:

[dreadings feed_url="http://delicious.com/v2/rss/joe/books" quantity=10]

The tags aren’t displayed by default. If you want to show them, change the line in this way:

[dreadings feed_url="http://delicious.com/v2/rss/joe/books" quantity=10 display_tags=true]

This is the full set of options you can use (the value shown here is the default one):

feed_url=""
quantity=5
display_desc=false
truncate=0
display_date=false
date_text="Stored on:"
display_tags=false
tags_text="Tags:"
display_hashtag=true
display_arrow=false
display_archive=true
archive_text="More posts"
display_arch_arr=true
new_tab=false
nofollow=true

Change default values according to your needs.

Usage as PHP function

As I already said, you can use the plugin calling the main function directly in your PHP files:

<?php if ( function_exists( 'dr_fetch_feed' ) ) {
    $args = array(
        'feed_url'         => '',
        'quantity'         => 5,
        'display_desc'     => false,
        'truncate'         => 0,
        'display_date'     => false,
        'date_text'        => 'Stored on:',
        'display_tags'     => false,
        'tags_text'        => 'Tags:',
        'display_hashtag'  => true,
        'display_arrow'    => false,
        'display_archive'  => true,
        'archive_text'     => 'More posts',
        'display_arch_arr' => true,
        'new_tab'          => false,
        'nofollow'         => true,
    );
    dr_fetch_feed( $args );
} ?>

Make sure to check if the opening <?php and closing ?> PHP tags are needed in your code. This is the full range of options — you can obviously use only those who need change.

The plugin is available on the WordPress repository and on GitHub.