=== Plugin Name ===
Contributors: 
Donate link: http://example.com/
Tags: better place, widget, donate, spenden, charity, gemeinnutzig
Requires at least: 3.0.1
Tested up to: 3.4
Stable tag: 0.95.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

This is a Plugin for integrationing a charity project of the platform betterplace.org to a Wordpress site. The plugin includes a Widget for displaying different project data. It is posible to display a list of needs that belong to the project. 

== Description ==

This is a Plugin for integrationing a charity project of the platform [betterplace.org](www.betterplace.org) to a Wordpress site. 

The plugin includes a Widget for displaying different project data. 
You can choose the static mode to display one betterplace.org project on every page that displays the choosen widget area.
Also the widget comes along with a dynamic mode in order to display different projects on different pages in the same widget area. 

There are sereval display options of the widget. It is posible to display just the project and a link to the donation screen or you can display a list of all or a number of needs that belong to the project.

### Feature List
* Display project and project need details of betterplace.org projects
* Display project and project need progress in sereval ways
* Add direct links to the donate screen of the project on betterplace.org
* Easy to use widget
* Use one widget to display different projects on different pages

### Upcoming Features
* Shortcode support
* Picture display of betterplace.org pictures
* Multi language support

== Installation ==

1. Upload all files to the `/wp-content/plugins/` directory
1. Activate the plugin through the 'Plugins' menu in WordPress
1. Place the Widget to a widget area and choose your options, or use the project object in your template files in order to display betterplace.org data.

== Frequently Asked Questions ==

= How I get the betterplace.org ID? =

Go to the project page on betterplace.org and look on the URI. 
The betterplace.org ID is the number after "projects/".
For example:
http://www.betterplace.org/de/projects/632-kinderhospiz-barenherz-leipzig-e-v
This project has the ID 632.

= Are there any shortcode options =

Actualy no. A shortcode feature is planed for the upcoming version. 

= How can I display different projects on specific Wordpress pages or posts =

Just use the dynamic mode of the widget. You have to add a widget area to the template of those pages or use the standart widget area of your Wordpress theme.
Then go to the page or post screen in dashboard and enter the corect betterplace.org ID of the project you want display into the box on the right side. May you have to activate this box on the screen options if it is not displayed.
After that go to the widget screen and drag and drop the widget area. Then set the widget to dynamic mode and choose display options of favor.

== Screenshots ==


== Changelog ==

= 9.5.1 =
* Important bugfixes. 
* Widget display scripts fixed.

= 9.5 =
* First version that was released.

== Upgrade Notice ==

= 9.5.1 =
Important bugfixes, please upgrade.