This time there nothing Mac-related, but something for the Wordpress Community.
Link Summarizer
Current Version: 1.6.2
Content:
- About Link-Summarizer
- Donate
- Download
- Installation
- Usage Examples
- Deinstallation
- Changelog
- Planned Features
- Feature Requests
- Bug Reports
- Support
About Link-Summarizer
I like it to have all links referred in a post summarized at the end of the post. That’s why i wrote a small little plugin for wordpress.In the admin panel you can configure which links should not be displayed in the summary, like the ones in this blog referring to different language versions of a post. You can use full regular expressions.
Donate
If you like the plugin consider donating a small amount to support further development. You can use PayPal or my Amazon Wishlist.
| PayPal Donation: | |
| Amazon.de Wishlist: |  Â
|
Â
Download
As I moved development of Link Summarizer over to the platform wp-plugins.org you can download the plugin directly from the servers of WordPress.org:
- Current version: 1.6.2
- Development version (may be completely broken)
- A list of all downloads (including old versions) is available here
Old download stats:
- Downloads Version 1.0: [download#2#hits]
- Downloads Version 1.1: [download#1#hits]
- Downloads Version 1.2: [download#3#hits]
- Downloads Version 1.2.1: [download#4#hits]
- Downloads Version 1.3: [download#5#hits]
Installation
Installation of the plugin is straight forward:
- unzip link-summarizer.zip into the plugin directory
- activate Link Summarizer in the plugin manager
- setup Link Summarizer via “Options” ->”Link Summarizer”
Usage Examples
Examples for regular expressions that could be used:The following are the rules I use in my blog at the moment of writing.
- ^?lan=.*
- ^?p=(d)*.*&lan=.*
- ^#.+
- http://mac.partofus.org/macpress/?p=d*#more-d*
These do the following:
- all internal links starting with “?lan=” are omitted, i use this for the language swithing links in my blog, matches on index page
- same as above, but for individual posts
- omit local anchors in the SAME post
- omit the “read more” link when using the_excerpt in your template or <!–more–> in individual posts
Another Example:If you never ever want to show any links to wikipedia, you could use the following:
- ^http://.*.wikipedia.org/.*
Deinstallation
[english]For uninstall deactivate the plugin in the plugin manager, then delete the plugin files from the file system.[/english]
Changelog:
- Version 1.6.2 [Release 31/05/2009]:
- feature added
- change filter priority from within the admin panel, no need to edit the source code
- Version 1.6.1 [Release 20/09/2008]:
- bug fixed
- title attribute was only searched right of href attribute, now also respects title attributes left of href attribute
- bug fixed
- Version 1.6 [Release 29/09/2008]:
- feature added
- use existing title attributes for summary display, can be selected optionally in addition to normal URL/text behavour
- redesign of settings page
- feature added
- Version 1.5.5 [Release 01/05/2008]:
- bug corrected
- corrected upgrade process from older version when settings have been added to the plugin options
- feature added:
- truncate link text if their length exceeds a specified limit
- bug corrected
- Version 1.5.4 [Release 22/04/2008]:
- bug fixed
- fixed readme.txt for compatibility with WordPress 2.5.1
- bug fixed
- Version 1.5.3 [Release 05/04/2008]:
- bug corrected
- when using thetemplate tag get_link_summary() now filters configured for the_content get applied, this is importent e.g. when using the plugin Markdown which stores only simplified markup code in the database. Thanks to Natalie Jost for poiting out the problem.
- bug corrected
- Version 1.5.2 [Release 10/03/2008]:
- Bugs corrected
- the configuration option for lnsum_onlyloopshow (omit changing the content via filter, only allow the template tag) (ticket #763)
- new configuration options included in later versions than the one originally installed now get predefined with sane defaults
- Bugs corrected
- Version 1.5.1 [Release 28/02/2008]:
- Bugs corrected:
- if called via filter the result of manipulating $content is returned instead of directly echoed out, thanks to P. Hofmann of contaxe.com for pointing this out
- further code cleanup for Wordpress coding guideline compliance
- Bugs corrected:
- Version 1.5 [Release 11/02/2008]:
- New Features:
- Theoutput of the plugin is now completely configurable through the admin interface, there needn’t be made changes to the plugin code to reflect special desing needs in you blog.
- Code cleanup for easier maintenance
- New Features:
- Version 1.4.2 [Release 09/11/2007]:
- New Features:
- option to show or hide link summary in RSS feeds
- searches by regular expressions can now be made case sensitive or case insesitive (admin option)
- the summary can now be called directly from the template files (”the loop”) to respect special design desires
- New Features:
- Version 1.4.1 [Release 08/11/2007]:
- design stylable through CSS, corrected wrong HTML tag
- New Feature: option to show the URL or the link text in summary
- Version 1.4 [Release 27/08/2007]: Thomas Ohms made the plugin aware of url rewriting. Also access to the userdefined custom fields was optimized.
- Version 1.3.1 [Release 14/08/2007]: bug on admin page: button “Update Options” is not shown
- Version 1.3 [Release 04/08/2007]:
- Check for empty regex, fixes an error reported by Andrew Perry
- New default regex: ^#.* omits all local anchors
- New feature: If a link occurs multiple times in the same posting, it is only included once in the summary (idea: Andrew Perry)
- Modified installation routine: On activation the plugin checks if all important settings are made, so that it can run out of the box without needing to change anything on the admin panel to use it
- Version 1.2.1 [Release: 02/08/2007]:You now can choose between POSIX and PCRE for the regex engine
- Version 1.2 [Release: 02/08/2007]:The output of the summary can now be disabled for the index page
- Version 1.1 [Release: 01/08/2007]:
- You now can define the default policy for displaying the link summary (enabled/disabled).
- For each post you now can define through custom fields, if the post should show a link summary independent of the global setting. Add a custom field named “lnsum_show” and change the value to “0″ to disable, any other value to enable.
- Version 1.0 [Release: 31/07/2007]: initial release
Planned Features
For information on features planned in the future see the appropriate forum posts. You can post in english or german language, I will translate the posts in this forum. Implemented items will be marked by the term “[implemented]” appended to the post title. To post to the forums you have to register an account here at this site.
Feature Requests
You can post your feature request in the forum. This helps to keep them documented and organized better than in the comments, which were used in the past for that. You can post in english and german language, I will translate the posts in this forum. You will have the ability to vote for features you wish to be implemented. Accepted feature requests will be moved to the planned feature forum. To post to the forums you have to register an account here at this site.
Bug reports
Please use the forum for error reporting on this site if you encounter an error. So every visitor has the chance to get informed about possible drawbacks when using the plugin. You can post in english or german language, I will translate in this forum. To post to the forums you have to register an account here at this site.
Support
I have created two support forums, one for posts in english and one for posts in german. Support questions should not be posted in the comments of this post. To post to the forums you have to register an account here at this site.
Zusammenfassung der Links
- Amazon Wishlist
- http://www.wp-plugins.org
- http://downloads.wordpre...nk-summarizer.1.6.2.zip
- http://downloads.wordpre...gin/link-summarizer.zip
- http://wordpress.org/ext...nk-summarizer/download/
- planned features forum
- Register Account
- feature request forum
- Error reporting forum
- English support forum
- German support forum
Great post! Just wanted to let you know you have a new subscriber- me!
Works great, thank you
hi. Thanks for plugin
perfect.
Regards
New Version 1.6.1 out, corrects a bug regarding the search for the title attribute
A new version of Link Summarizer is available.
You can download version 1.6 from http://wordpress.org/extend/plugins/link-summarizer/
New feature: title attribute of links can now be displayed optionally if existing
Redesign of admin interface
This is exactly what i was looking for.
Hi
I really like your plug in but don’t understand how to “hide” a link in the link summary. ie if it’s a really short post with a few links, then the link summary is directly below (doubling up).
In layman’s terms, can you please help with how I tell the plug-in of specific links I don’t want summarised at the bottom?
thanks so much. let me know if you need me to send you an example post.
Hello,
I just discovered your plugin and like it a lot.
I think a third option for displaying the link would be useful, which would be using the title attribute. The link itself or the text anchor might be not so explanatory.
Feature request – support for image tags, accepted
Thanks CyberSilver for your feedback, this really helps in development.
I’m not sure where to leave feature requests, but here goes…
I would appreciate it if Link Summarizer would detect ‘img’ tags in the links and use the ‘title’ instead, if available, otherwise the links alt. If no text alternative is available, then use the image.
This should make the link list much cleaner.
Thanks, great job ! regards
hi. Thanks for plugin
perfect.
best regards
baron
Eddie, that was super fast, thank you! I’ll test it out soon, but I’m sure it works great. I appreciate your help, it’s a fabulous plugin!
@Natalie
Your problem is solved in version 1.5.3.
Best regards,
Eddie
Hi Natalie,
I installed the Wordpress Markdown Plugin from http://michelf.com/projects/php-markdown/ in my development environment and tested it with links like the following
<mailto:text@example.local>
<http://www.example.local>
and experienced the same output as you. Explaination for this is: As when using the template tag the content of your post must be read directly from the database. In this entry there is only the link markup used when creating the content. To get the rewritten output with fully expanded link tags <a href… it would have to be filtered through the function the_content(), which is only available inside the Wordpress Loop. ATM I have no idea how to work around this problem.
But I will investigate further.
Hey there, thanks so much for this. I’m no programmer so it’s nice to be able to add features like this. I’ve noticed something though and I’m not sure if I should call it a bug or not since nothing’s technically broken.
I use Markdown in my posts…
When the links are shown automatically, they work fine. It seems to find the links just fine, even with Markdown.
BUT… when I call them from the sidebar using the function manually it only finds links coded with html (not Markdown).
Is this something that can be easily fixed? If so, I’m totally comfortable editing the plugin. I’m just not sure what to change to fix this.
Thanks!
Ideally, option 1:
“by default set the syntax to the one used for new installations if no input is made for the fields”
This means it would ‘just work’ without user intervention.
Possible solutions to your problem:
- by default set the syntax to the one used for new installations if no input is made for the fields you mentioned
- give the default as example in the options page of the plugin
Which one do you prefer to be implemented?
Argh .. the HTML tags in the comment above got stripped (guess I should have expected that … but there’s no preview for comments here !).
You get the idea anyhow. You can add various HTML tags in between the %variables% above to format the link summary. The key point is, the plugin will not work unless the two fields under “Code to be used to display the link summary:” contain something.
I noticed when I upgraded to version 1.5.1, the two fields under “Code to be used to display the link summary:” were empty, resulting an a misconfiguration error.
On fresh installs of the plugin, these were pre-filled with:
%SUMMARY_TITLE%%LINKLOOP_START%%CURRENT_LINK%%LINKLOOP_END%
Adding this template code to the ‘upgraded’ plugins solved the problem.
Just thought I’d document this here as a gotcha for those upgrading.
Thank you for the excellent plugin
Thank you for the hint, the download link was corrected.
I think the link to the “Current version: 1.5.1″ is incorrect, it points to version 1.4.2.
Great plugin. Works great with WPMU with a couple of minor tweaks. Also, I submitted a ticket for a potential bug.
There’s a new version out, 1.5:
@Caroline: Glad to help you.
Thanks, Eddie! I wish I could have gleamed that from the RegEx site as easily as you just explained it. I finally got it working with the following (in case anyone else bumped into the same problem).
javascript:void()
http\:\/\/www\.bloglines\.com\/sub\/http:\/\/midthought.org\/toft\/.*
http\:\/\/digg\.com\/submit\?phase\=2&url=http:\/\/midthought.org\/toft*
http\:\/\/del\.icio\.us/post\?url\=http\:\/\/midthought.org\/toft/*
http\:\/\/www\.facebook\.com\/share\.php\?u=http://midthought.org/toft*
http\:\/\/reddit\.com/submit\?url=http\:\/\/midthought.org/toft*
http\:\/\/www\.stumbleupon\.com/submit\?url\=http\:\/\/midthought.org/toft*
http\:\/\/technorati\.com\/faves\?add\=http\:\/\/midthought.org/\toft*
@Caroline:
After looking at your site I suggest the following regular expressions (no guaranty):
http:\/\/www\.bloglines\.com\/sub\/http:\/\/midthought.org\/toft\/.*
http:\/\/digg\.com\/submit\?phase=2&url=http:\/\/midthought.org\/toft\/.*
http:\/\/del\.icio\.us\/post\?url=http:\/\/midthought.org\/toft\/.*
and so on.
Remember to escape special characters in the regex, e.g. “/”, “.”, “?” by adding a leading “\” (backslash) to them.
Another possible solution could be to change the precedence setting of the plugin so that it gets executed before your bookmarking plugin, but that needs hacking the plugin code at least of Link Summarizer (+ knowledge of the precedence setting of the bookmark plugin).
Caroline
Try this one:
.*\?url=http://midthought\.org/toft/.*
Caroline
Try this one:
.*\?url=http://midthought\.org/toft/.*
I am trying to get the Link Summarizer to work such that it doesn’t list social bookmarking links added to each post by the I Love Social Bookmarking plugin. It must just be my not understanding RegEx syntax properly, but basically, since the links change dynamically from post to post, I would need to specify in the RegEx area to disregard “http://reddit.com/submit?url=http://midthought.org/toft/*” — I just can’t seem to get it to work properly though.
I write a small modification for limiting URL that displayed. Sorry if this feature already exist:
http://layangan.com/asfik/blog/2007/12/12/link-summarizer-patch
Thank you for the excellent plugin
BUG:
– add modifier ‘i’ (case insensitive) to preg_match_all:
preg_match_all(’/(.+?)/i’, $content, $matches);
FEATURE REQUEST:
– add the following option: “Show summaries in RSS”. Below is implementation:
if (is_feed())
$lnsum_show = FALSE;
Thank you!
A new release of Wordpress Plugin “Link Summarizer” is out. Current Version 1.4.1
The changes made are:
- bug fixes: corrected html tags
- new features:
– option to show links as URL or as their link text in the summary
– stylable with CSS, see the style.css.sample file included in the current release
I hope these changes reflect the user demand.
Hallo Christoph,
danke für das Plugin! Es funktioniert super.
Noch eine Anregung für ein nächstes Update: Begrenzung der Zeichenzahl
Ich hatte das Problem, dass einige Linktexte sehr lang waren und über die Seitenbreite liefen.
Ich habe das Plugin modifiziert und die Textlänge der angezeigten URL auf 70 Zeichen begrenzt (mittels “substr”). Außerdem entferne ich auch immer automatisch das “http://” aus dem Linktext.
Viele Grüße,
René
I’m in the move to gather features you’re missing before release of the next version. The next version (1.4.1) will include the following fixes:
- CSS styling possible
- eliminated a wrong html tag
Further suggestions are welcome.
That feature is one thing I find most annoying on some websites: you MUST click multiple times and navigate through the different presentation levels to get all the information you want to get. I won’t do this for Link Summarizer, but feel free to implement it. In my opinion it’s sufficient to have an option to exclude the summary on the index page and only display them, if a single post is viewed.
Lovely plug that I used most of the time for my blog! I will always use it if there is an option of collapse: require user to click to show the links!
Anyways thx a bunch.
Testing your plugin and I really like the concept. Very nice! One issue though. I went through the trouble to get my set of regex’s entered into the Options page but for the life of me I cannot see an ‘Update/Save/Etc’ button! I might be rash sometimes but I have looked and looked. The only button I see is the ‘delete’ one for Delete settings from the database. I’ve copied my regex’s into notepad for now but am I missing something? Hope to hear back!
Nice plugin … I’ve alway liked this feature at the end of IBM developerWorks articles … now we can all use it in our blogs.
Some bugs / feature requests:
1. If I don’t provide any regular expression, I get some PHP errors at the top of the post due to the empty regex. The plugin should handle the case where no regex’s are provided more gracefully.
2. If a link appears in the post multiple times, it is listed multiple times in the link summary … it would be much nicer if the link summary contained only one instance of each link.
3. My feeling is that almost everyone would want the regex “^#.+” in by default .. but maybe thats just me. Another nice feature would be to make a few checkboxes like “Omit local anchors (^#.+)” to make it really easy for novices to turn on some obvious regexs that they probably want.
I have added examples for regular expressions.
Hope this helps.
Don’t you have instructions in English? I tried to install it, but I couldn’t costumize it.
Best,
Paulo.