This is a Plugin for integrationing a charity project of the platform betterplace.org to a Wordpress site.

art-and-the-machine

<p>This is a Plugin for integrationing a charity project of the platform <a href="www.betterplace.org" rel="nofollow ugc">betterplace.org</a> to a WordPress site.</p>
<p>The plugin includes a Widget for displaying different project data.<br />
You can choose the static mode to display one betterplace.org project on every page that displays the choosen widget area.<br />
Also the widget comes along with a dynamic mode in order to display different projects on different pages in the same widget area.</p>
<p>There are sereval display options. 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.</p>
<h3>Feature List</h3>
<ul>
<li>Display project and project need details of betterplace.org projects</li>
<li>Output project and project need progress in sereval ways</li>
<li>Add direct links to the donate screen of the project on betterplace.org</li>
<li>Easy to use widget</li>
<li>Use one widget to display different projects on different pages</li>
<li>Progress display (per cent & progress bar)</li>
</ul>
<h3>Upcoming Features</h3>
<ul>
<li>Shortcode support</li>
<li>Picture display of betterplace.org pictures</li>
<li>Multi language support</li>
</ul>
<h3>Arbitrary section</h3>
<h3>Better Press API Documentation</h3>
<h4>am_bpProjectController</h4>
<p>The <code>am_bpProjectController</code> is the main Object for displaying betterplace.org data. To use it in custom template files just create a new instance, add a betterplace.org ID and use the get methods.</p>
<p>Example:<br />
    $bp_projectObject = new am_bpProjectController();<br />
    $bp_projectObject->addProject(7910);<br />
    echo $bp_projectObject->getProjectTitle();</p>
<p>This will display the Title of the project that has the ID 7910.</p>
<p>You are able to display project needs in the same way.</p>
<p>Example:<br />
    $bp_projectObject = new am_bpProjectController();<br />
    $bp_projectObject->addProject(7910);<br />
    echo $bp_projectObject->getNeedTitle();</p>
<p>This will display the title of the first need of the project that have the ID 7910.</p>
<p>In order to display more than one need you can use the <code>nextProject()</code> method to switch needs. It returns <code>false</code> when no more needs are left:</p>
<p>Example:<br />
    $bp_projectObject = new am_bpProjectController();<br />
    $bp_projectObject->addProject(7910);<br />
    echo ‘</p>
<h3>‘.$bp_projectObject->getNeedTitle().’</h3>
<p>‘;<br />
    do{<br />
    echo ‘</p>
<h4>‘.$bp_projectObject->getNeedTitle().’</h4>
<p>‘;<br />
    }while($bp_projectObject->nextProject());</p>
<p>This will display all titles of needs of the project that have the ID 7910.</p>
<p>In order to display more than one project use the method <code>nextProject()</code> in the same way. First you have to add all projects and after that you are able to switch projects:</p>
<p>Example:<br />
    $bp_projectObject = new am_bpProjectController();<br />
    $bp_projectObject->addProject(7910);<br />
    $bp_projectObject->addProject(932);<br />
    $bp_projectObject->addProject(1032);<br />
    do{<br />
    echo ‘</p>
<p><</p>
<p>h3>’.$bp_projectObject->getProjectTitle().’</p>
<p><</p>
<p>h3>’;<br />
    }while($bp_projectObject->nextProject());</p>
<p>This will display the titles of the Projects that got the ID 768, 932, 1032.</p>
<h3>All methods of am_bpProjectController</h3>
<h4>addProject($id)</h4>
<p>Add a betterplace.org project to the stack.</p>
<h4>nextProject()</h4>
<p>Moves the project pointer to the next project. Returns <em>false</em> if no more projects are on stack.</p>
<h4>nextNeed()</h4>
<p>Moves the need pointer of the pointed project to the next need. Returns <em>false</em> if no more projects are on stack.</p>
<h4>firstProject()</h4>
<p>Moves the pointer to the first project on the stack.</p>
<h4>getProjectID()</h4>
<p>Returns the betterplace.org ID of the project that is pointed.</p>
<h4>getProjectTitle()</h4>
<p>Returns the title of the pointed project.</p>
<h4>getProjectDescription($maxnumber, $option)</h4>
<p>Returns the description of the project that is pointed. It acepts two arguments to limitade the description. <code>$option = 0</code> will limit count of letters that is specified in <code>$maxnumber</code>, <code>$option = 1</code> limits <code>$maxnumber</code> words.</p>
<h4>getProjectAmount($option, $format)</h4>
<p>Returns money amounts of the project. If <code>$option = 0</code> it returns the amount of money that is still needed to fulfil the project. <code>$option = 1</code> returns the monay that is already donated and <code>$option = 2</code> is the complete amount that has been requested. The argument <code>$format</code> specified the display of the amount. <code>$format = 1</code> returns the amount in Euro formated as usual in Europe. If <code>$format = 0</code> the method returns the complete amount unformated in Cents. <code>$format = 2</code> returns only the amount of Euros without cent amounts. <code>$format = 3</code> returns only the amount of Cents like if you would cut the full Euro amounts away.</p>
<h4>getProjectProgress()</h4>
<p>Returns the progress of the project in per cent.</p>
<h4>getProjectLink($option)</h4>
<p>Returns links belonging to the project that is pointed. <code>$option = 0</code> will return the link to the project page. <code>$option = 1</code> will the link that leds directly to the donation page of the project.</p>
<h4>getProjectOpinions($option)</h4>
<p>Returns the number of opinions about the project on betterplace.org. If the argument is set to <code>$option = 0</code> you will get the total number of opinions. If <code>$option</code> is set to <code>1</code> you’ll get the number of positive opions, if it is set to <code>2</code> you’ll get the count of negative opinions.</p>
<h4>getProjectDonors()</h4>
<p>Returns the total number of donors which have already donated the pointed project.</p>
<h4>getProjectNeedCount()</h4>
<p>Returns the number of needs of the project that is pointed.</p>
<h4>getNeedID()</h4>
<p>Returns the ID of the need that is pointed.</p>
<h4>getNeedDate($option)</h4>
<p>If <code>$option = 0</code> this method will return the date of creation of the need. If <code>$option = 1</code> it will return the date of the last update of the need.</p>
<h4>getNeedTitle()</h4>
<p>This method returns the title of the pointed need.</p>
<h4>getNeedDescription($maxnumber, $option)</h4>
<p>Returns the description of the need that is pointed. It acepts two arguments to limitade the description. <code>$option = 0</code> will limit count of letters that is specified in <code>$maxnumber</code>, <code>$option = 1</code> limits <code>$maxnumber</code> words of the need.</p>
<h4>getNeedProgress()</h4>
<p>Returns the progress of the pointed need in per cent.</p>
<h4>getNeedAmount($option, $format)</h4>
<p>Returns money amounts of the need. If <code>$option = 0</code> it returns the amount of money that is still needed to fulfil the need. <code>$option = 1</code> returns the monay that is already donated and <code>$option = 2</code> is the complete amount that has been requested. The argument <code>$format</code> specified the display of the amount. <code>$format = 1</code> returns the amount in Euro formated as usual in Europe. If <code>$format = 0</code> the method returns the complete amount unformated in Cents. <code>$format = 2</code> returns only the amount of Euros without cent amounts. <code>$format = 3</code> returns only the amount of Cents like if you would cut the full Euro amounts away.</p>
<h4>iscompletedNeed()</h4>
<p>This method returns true, if the need is already completed.</p>


Alternatives to BetterPress

Top alternatives