Sinn City Wiki

feedreadingblogroll:start

Jan — Wed, 02 Dec 2009 19:32:42 +0100

feedreadingblogroll:configuration

Jan — Thu, 26 Nov 2009 10:29:30 +0100

feedreadingblogroll:upgrading - angelegt

Jan — Sun, 20 Sep 2009 15:29:02 +0100

Upgrading

You are encouraged to use the plugin-upgrade-function that WordPress is offering.

However. if you would you are preferring a manual upgrade, follow these steps:

Download the most recent zip-file of this plugin and extract the contents.
On your server, where your WordPress-installation is located, delete the contents of this directory: `/wp-content/plugins/feed-reading-blogroll/*`
Upload all the new plugin-files to this directory (`/wp-content/plugins/feed-reading-blogroll/*`).
Login to your admin-dashboard and go to the plugin's options-page.
Click on the JavaScript-tab and push the rebuild-button to generate a new JavaScript-file on the server.

That's it

feedreadingblogroll

Jan — Sun, 20 Sep 2009 15:16:35 +0100

feedreadingblogroll:language - angelegt

Jan — Sun, 20 Sep 2009 14:59:28 +0100

The plugin comes with support for Danish, English, Italian, Portuguese, Spanish, Turkish and German blogs. It can be translated into other languages as well. If you like, you can take the file feedreading_blogroll-de_DE.po and use it as the basis for a translation into your own language. You can contact me, if you have translated the file and I will add the new language to my plugin.

Currently these languages are supported:

Belorussian, thanks to Ilyuha
Danish, thanks to Georg
English, by me
French, by Steve
Italian, thanks to Gianni Diurno
Portuguese, thanks to Jorge Silva
Russian, thanks to Fat Cow
Spanish, thanks to JC Julien
Swedish, thanks to Markus Wallgren
Turkish, thanks to Çağdaş
German, by me

Place the language-file (just the one with the .mo-extension) inside ##/wp-content/plugins/feed-reading-blogroll/lang##.

Download the latest language file here.

feedreadingblogroll:accuracy - angelegt

Jan — Sun, 20 Sep 2009 14:55:38 +0100

About Accuracy

How accurate is the update-data for the bookmarks?

This depends on the data provided by your blog and your bookmarked sites. Imagine this: a new article was written on June, 15th 2008 at 09:00 hrs PDT (realtime), but the blog’s feed provides the timestamp of June 15th 2008 at 08:00 hrs CET. The plugin will use 08:00 hrs CET to calculate the age of the last update.

And it is the same with the date provided on your blog’s server. If this date is inaccurate, the information provided by this plugin will be inaccurate.

feedreadingblogroll:performance - angelegt

Jan — Sun, 20 Sep 2009 14:55:14 +0100

Performance

The feed-date is fetched from Google by using the Google AJAX Feed API.

So the performance relies heavily on Google. The pageload should only be affected in a minimal way.

However, as the widget relies heavily on remote data and the performance of remote servers hosting the feeds, it may happen that you will suffer from poor performance from time to time. In those cases you can deactivate the display of the date-information at the options-panel.

feedreadingblogroll:styling - angelegt

Jan — Sun, 20 Sep 2009 14:54:49 +0100

Styling the Blogroll with CSS

This is an example of the XHTML-code that this plugin will generate. You can use the defined classes and ids to apply your css-styles to the elements.

The plugin comes with a css-file named feedreading_blogroll.css. You can modify this file to change the look of the blogroll. If you apply any changes to the file, you should move it to another directory on your server (e.g. /wp-content). Otherwise, the file and your changes might get lost during a plugin-update. You can set the new location of your modifed feedreading_blogroll.css in the plugin’s options. The location must be a valid URL (e.g. http://yourblog.com/wp-content/feedreading_blogroll.css).

Remember that the classes seekxlsnaprM and previewlink for the anchor-element are defined by you over the plugin-options.

<!−− begin of widget (widget only, not generated by template-tag) −−>
<li id="widget_feedreading_blogroll" class="widget widget_feedreading_blogroll">
<!−− widget heading (widget only, not generated by template-tag)−−>
<h2 class="widgettitle">Blogroll</h2>
<ul>
<!−− begin of bookmark-entry −−>
<li class="feedreading_bookmark">
		  <img /> <a class="seekxlsnaprM previewlink">xyz</a>
		  <div class="lastPublicationDate">
			   <abbr></abbr>
		  </div>
		  <div style="display: none">
		  <p><small style="cursor: pointer"></small></p>
		  <div>Loading…</div>
		  </div>
</li>
<!−− end of bookmark-entry −−>

feedreadingblogroll:linkpage - angelegt

Jan — Sun, 20 Sep 2009 14:53:41 +0100

How to Create a Linkpage

Sometimes you don’t want to have a list of your bookmarks in your blog’s sidebar, but on a separate page. In this article I would like to give you a small tutorial on how to do this.

Solution: WordPress page-template

To create a linkpage you have to go to your current theme-directory and make a copy of the file page.php. It is very likely that the listings further below will not work with your theme. You have to work with a copy of the file page.php from your theme.

For this tutorial, the copy is named page-feedreading-blogroll.php, but you can choose any name you want.

So we start by copying page.php from your theme-directory and by naming the copy page-feedreading-blogroll.php.

Now, we open page-feedreading-blogroll.php in an editor. The file might be looking something like this. Your file might be looking quite differently.

But one similarity will be there: the content-template-tag:

<?php the_content(); ?>

You will find this tag in the listing of page.php below: page.php / unmodifiyed page-feedreading-blogroll.php:

<?php get_header(); ?>
<div id="content-container">
<div id="content">
<div id="body">
		<?php if (have_posts()) : while (have_posts()) : the_post(); ?>
		<div class="post" id="post-<?php the_ID(); ?>">
		<h2><?php the_title(); ?></h2>
				<div class="entry">
						<?php the_content(); ?>
				</div>
		</div>
		<?php endwhile; endif; ?>
		<?php edit_post_link(‘Edit this entry.’), ‘<p>’, ‘</p>’); ?>
</div>
<?php if ( get_option(‘page_setup’) != ‘no-sidebar’ ) get_sidebar(); ?>
</div>
<div class="clear"></div>
</div>
<?php get_footer(); ?>

Just below of the_content(); is the best place for the template-tag of the blogroll. Furthermore, notice the first five line of the modified page-feedreading-blogroll.php. A name for the template was added. In this case it’s Feed Reading Blogroll Page. Apply the changes to your own template and save them.

Now that the plugin’s template-tag and the template-name have been added, the modified file should look something like this: modified page-feedreading-blogroll.php:

<?php
/*
Template Name: Feed Reading Blogroll Page
*/
?>
<?php get_header(); ?>
<div id="content-container">
<div id="content">
<div id="body">
		<?php if (have_posts()) : while (have_posts()) : the_post(); ?>
		<div class="post" id="post-<?php the_ID(); ?>">
		<h2><?php the_title(); ?></h2>
				<div class="entry">
						<?php the_content(); ?>
						<?php feedreading_blogroll(); ?>
				</div>
		</div>
		<?php endwhile; endif; ?>
		<?php edit_post_link(‘Edit this entry.’), ‘<p>’, ‘</p>’); ?>
</div>
<?php if ( get_option(‘page_setup’) != ‘no-sidebar’ ) get_sidebar(); ?>
</div>
<div class="clear"></div>
</div>
<?php get_footer(); ?>

This modified file should now be uploaded to the directory of your theme.

Now, go to your blog’s admin-section and create a new page.

Toward the bottom of the Write > Page administration panel (or on the sidebar, depending on which version of WordPress you are using) is a drop-down labeled “Page Template.” From there you can select which Template will be used when displaying this particular Page.

Select the page template called “Feed Reading Blogroll Page” – that is the one you have just uploaded to your theme-directory.

Save and publish the page.

That’s it – view the page on your blog. It should contain the blogroll! Further resources at the WordPress codex

feedreadingblogroll:addingfeedurls - angelegt

Jan — Sun, 20 Sep 2009 14:49:51 +0100

Adding Feed-URLs and Icons to bookmarks

To prepare your bookmarks for the widget, no bookmark needs to be changed. Instead, you may add an additional feed-URL to each of your bookmarks (see screenshot above). This feed-URL can be entered into the “advanced settings”-section of your bookmark-entries.

You don’t need to supply feed-URLs, if you have activated the Google Feed discovery option.

This is the part of your bookmark-management, you probably know already …

… if you scroll further down, you will find the section, where you can enter an additional feed-url and an icon-url for each bookmark. The plugin will use the data you saved here.