=== Plugin Name ===
Contributors: BenjaminSommer
Donate link: 
Tags: navigation, external resources, linking, network, academic, further reading, references, blogsearch, pingbacks, bibliography, citation, caption, footnotes, MLA, APA, Chicago, Turabian
Requires at least: 2.8
Tested up to: 3.0
Stable tag: 1.4.2

Connect posts, pages and external resources (websites, pdf, doc, zip, exe,...). Use Caption, Cross-references, Bibliography.

== Description ==

Netblog is a tool to connect posts, pages and external resources (websites, pdf, doc, zip, exe,...) and display them as Further Reading and References for your visitor.
Ideal to publish current academic work of a workgroup, to create a knowledge-based website to refer to additional interesting websites, to link to documents in the internet, 
or just to connect content-related posts, or whatever you want to refer to. 

**Using** it is quite simple. Go to edit-post / edit-page and look for metabox `Further Reading`. Type in your query and a list of matches is shown below using autocomplete.
Click with your mouse on one of the rows and the autocomplete box disappears. The link fades in smoothly below of where you typed your query. 


**Features**

* `Bibliography`/References: list cited work within your text automatically at the bottom of the page and adhere to strict citation styles, like `APA, MLA, Chicago and Turabian`. Add custom styles if needed.
* `Settings Page`
* AJAX to add links immediately to the post/page currently being edited, without reloading
* Two integrated widgets: `Referenced By` and `Further Reading` to display the links in the sidebar for the visitor
* `Websearch APIs` to look for resources in the World Wide Web.
* Incoming links can be displayed, using `Blogsearch` technologies.
* `Pingbacks` as remote comments can be automatically displayed in the widget References (see settings).
* `Manage External Resources`: list and search links, trash and erase them, check online status, automatically update their titles, perform batch operations

**Tip**

* Use `Reference Maker` to make your life easier.
* Check and Update extern links regularly in NB-MEL, so that dead link are not listed for your visitor.
* Take a look at the settings, whether to list footnotes as decimals, alphas, roman or greek letters, for example.
* Move metabox Further Reading below your favorite post editor to see the autocomplete box better. 


Supported Web browers: Google Chrome, Microsoft Internet Explorer 5  and above, Firefox 3 and above.

More Screenshots at netblog.benjaminsommer.com.


== Installation ==

= Fresh Install =
1. Download the latest stable version of Netblog.
1. Extract the archive to your Wordpress Plugins directory `/wp-content/plugins/`
1. `Activate` the plugin through the Plugins menu in WordPress. 
(`DO NOT use Network Activate` at the moment)

= Update =
1. `Delete old widgets` from your sidebar
1. `Download` new version files to your previous installation
1. I recommend to make a `backup of your Wordpress database`, since Netblog 1.3 updates its database tables.
1. `Deactivate and Activate` the plugin

== Frequently Asked Questions ==

= How to add custom search templates? =

Go to Settings > Netblog - if not listed, you have not enough privilege.

= How to reference cited work within one post/page? =

To make it simple and short, in your favorite editor, just copy the nbcite-tag to a second place in your document. In each case, to 
identify a certain citation, your nbcite-tag must include at least author, title, year, month, day and pages (if not empty) - it will refer to
the first use in your document.

= Citation: how to choose a custom, local cite-format? =

Use [nbcite print_custom="$author ($year)" ... ] to display something like: "when you want to cite a book by Daniel Hobsen (2010) in a style that suits best
to your text, this print_custom in your nbcite-tag".

= Caption: can I override a global caption style? =

Yes, you can, although I would not recommend it - a lot of different styles for one caption type within your website is most likely not a good idea. But if you still want to, 
your nbcaption-tag must look like this: [nbcaption local="true" print="($number)" type="lower-greek" ... ]

= How to show the section `Further Reading`? =

Go to `Widgets` and drag the widget `Further Reading` into one of the widget areas. If done so and no links will show up, the maximum number of
visible links of each link type might be 0. The widget must be displayed on at least one of the types: posts, pages or others.

= The public hyperlinks are to too long. What can I do? =

Go to Widgets and lower the value `truncate each hyperlink to [] characters`. 

= How to add an external link? =

Go to `Edit Post` and look for the box `Further Reading`. Type in the field below (`Search for resources`) a certain keyword, like `www` or
like `http://`, and then type your search query, e.g. `www wordpress plugin netblog`. A list of close matches should appear below. If it 
does not appear, try one of the supported web browers.

= I got the message 'Cannot add link' while trying to add a link =

`Deactivate and then activate` the plugin. The Reason: The database tables are not installed properly. This happens as of Wordpress 3.0 with MU enabled, 
when activating the plugin networkwide (link: 'Network Activate'), because Wordpress 3.0 does not run this feature properly at the moment.

= How can I remove a link? =

Go to `Edit Post` and in the box `Further Reading`, click on the `x-icon` on the left side of every link. The link disappears 
apon successful removal.

= Missing Links in Widget `Further Reading`? =

In the widget Further Reading, besides external resources, posts and pages are listed as soon as they are published. All other types, 
such as drafts or trashed items are not displayed. When you restore a trashed item, all its previous links will be restored and displayed for
the public visitor.

= There are no (dynamic) incoming links of the Google Blogsearch! =

Your webpage might be new or not quite popular, so that Google Blogsearch has not yet found a foreign website linking to your current webpage.
Building an index usually takes a bit of time for Google. Don't stop editing and posting.

= In MEL, some invalid links are not marked as offline =

If you are using Wordpress on a server behind your ISP, for example, the reason might be that your ISP returns a custom page whenever a URL is not found.
 

== Screenshots ==

1. **Overview**: widgets Further Reading and References on the public website.  
2. On **edit-post/page**: add content-related resources for each of your posts and pages, just by typing your query in the field `Search for Resources`, 
e.g. `Image-base` for internal posts and pages, `www graphics animation dreamworks` for resources in the World Wide Web. An autocomplete box will appear,
if possible matches were found.
3. Version 1.2: **new pdf-icon**
4. **Manage External Links** (version 1.3)
5. `Reference Maker`: Captions like Equations, Figures, Tables, Headlines, Chapters, etc...
6. `Bibliography`: Use default, APA, MLA, Chicago, Turabian or a custom style to list your cited work in your page.
7. `Citation`: with 19 built-in types of work to cite and up to 37 attributes, it can be used for most cases.

== Changelog ==

= 1.4.2 =
* Enhanced Security and userbility of adding custom citation styles 
* Immediate feedback while typing cutom citation style (see settings)
* Fixed Bug in cross-reference captions
* Fixed Bug in Reference Maker: cross-reference captions

= 1.4.1 =
* New Option in settings - citation: Improve site-wide consistency of used citation styles by forcing alls bibliographies to use the default style.
* Fixed Bug in Settings.

= 1.4 =
* New Settings page under Setting -> Netblog
* New Feature: Custom Search in NB-MEL
* New Academic Features: Footnotes, Citation, Caption, Bibliography, Cross-reference Captions, custom Cite Styles 
* New Metabox: Reference Maker
* Moved page Posts | Extern Links to `Links | NB-MEL`
* Important: increased security levels

= 1.3 =
* New Feature: Manage External Resources (list, trash, erase, restore, check online status, update titles automatically)
* Update Database organisation - external resources
* Update Autocomplete box: more stable, smooth listing
* Update Metabox References - List of links: fade in new links
* Bug fixed: IE moving Metabox disappeared
* Renamed Widget References to Referenced By

= 1.2 =
* New Feature: Link to pages within the website
* New Feature: Pingbacks
* New Feature: Display Widgets on posts, pages and/or any other type.
* Revised Widgets settings area: truncate links; maximum number of links for each link type; custom order of link types
* Updated Widgets: PDF-Icon for external pdf-file resources in the public area (in the list shown on a post or page)
* Updated Widget 'References': Use of icons for external links returned by blogsearch
* Updated Admin edit-post/page page: list of links in alphabetical order. First internal links, followed by external links.
* Updated Config: constants NETBLOG_BLOGSEARCH_PROVIDER_NAME and NETBLOG_BLOGSEARCH_PROVIDER_URI added
* Updated Widget Descriptions
* Fix Widgets - List of links: use of an URI indexer to prevent duplicates.

== Upgrade Notice ==

= 1.4.2 =
* Enhanced Security and userbility of adding custom citation styles 
* Important bug fixes

= 1.4.1 =
* Fixed Bug in Settings

= 1.4 =
* A complete reference wizard to manage your citation, footnotes and captions.
* Enhanced Security and Settings Panel
* Custom Search in NB-MEL.

= 1.3 =
* New Feature: Manage External Resources
* More stable autocomplete box while typing a query
* Metabox References: smooth fade in new link
* Bug fixed: IE moving Metabox disappered

= 1.2 =
* A couple of new features, including pingbacks, links to pages
* More detailed settings for the widgets
* Minor fixes

= 1.1 =
* First public version