Architecture

We know that it can be hard to coordinate events, collect data and also remember all the different information you need to remember. We want to make it a bit easier by providing forms to capture data (e.g. tree signups), an admin dashboard to coordinate your events and volunteers. All that is built on an infrastructure that is extendable so you can add features you need if you want.

Apart from our backend for coordinating your events we also provide widgets to make it easier for your website visitors to connect to your project.

What are widgets?

A widget is a little piece of functionality that you can add to your website to make it easier for your visitors to sign up for an event or signup a tree. You can browse the examples on the left to get a better idea of what they can do for you.

Do I need to write code?

The basic idea of widgets is that you don't need extensive programming knowledge to embedd them into your existing page. The following example was taken from our pflueck.org website where we provide signup forms for trees, volunteers and charities.

Backend (Alpha example)

Here's an example of a field where you can add some additional information to your events and assign locations and tree owners (that may have a phone log and other information so it's useful to link them here).

Developer API

This documentation is meant as a guide to our own developers as well to others who want to extend the platform or build their own site based on it.

We provide a simple rest API that is available on http://api.fruittreeproject.org/explorer on which all of our widgets are built on. Moreover we have a AngularJS library available in case you want to program your own pages in JavaScript.

http://api.fruittreeproject.org/dist/0-0-1/fruitTreeProjectServices.js

Basis principles

All non-authenticated calls require a chapter id so we know which fruit tree project you are refering to.

Setting up your site

The easiest way to use the FruitTreeProject Platform is to include one of the widgets that we provide (see examples on the left) - however, you always have the opton of using our API directly and writing some lines of code yourself.

To use our forms and other features you will need to add our CSS styles and FruitTreeProject application. We natively use Bootstrap 3 - if you have already included it, you don't need to add it here.

coming soon

Data model

There are two central entities in our data model. The location holds all the information of places where fruit can be picked, the event organizes the harvests by remembering attendees, dates and related todos (like: who brings a ladder?).

Since we don't only have one organization using the system we're splitting the FruitTreeProject.org into chapters. Each organization is its own chapters with events and locations.

Widgets

Widgets are small things like forms, event lists or maps that you can drop onto your project website to make it easier to coordinate and find events.

Public event list

We are currently building this library of examples. Please stay with us while we bring this new site online and feel free to comment in the meantime.

The public event list widgets shows all upcoming events for your area.

 

Tree signup form

We are currently building this library of examples. Please stay with us while we bring this new site online and feel free to comment in the meantime.

Work in progress

User login

We are currently building this library of examples. Please stay with us while we bring this new site online and feel free to comment in the meantime.

Work in progress

Event Map

We are currently building this library of examples. Please stay with us while we bring this new site online and feel free to comment in the meantime.

Work in progress

Todos

We are currently building this library of examples. Please stay with us while we bring this new site online and feel free to comment in the meantime.

Work in progress