Open Source Ecology - User contributions [en]

OSE Microfunding Proposal/Implementation

2011-07-27T22:46:47Z

Kelly Schutt: /* Paypal updates 6-27-11 from Kelly Schutt */

=Terminology=
Here is the common terminology:
* TF = True Fan

=Design=
==Wireframes==
The wireframes of the proposal were implemented in [http://www.lumzy.com/ Lumzy].

=Development=
==PHP CMS==
We chose Drupal.

==Drupal Environments==

* Drupal-test - http://microfundingtest.openfarmtech.org/ - used for development and testing
* Official Drupal - http://civicrm.opensourceecology.org/ - used for real

==Page Flow==

[[Image:Ose-microfunding-proposal-flow.png|600px]]

===True Fans Page===
* Description
** Showing motivational content about OSE, its importance, tangible outcome, etc.
** Allowing subscription.
* Transitions
** Recognition Page
*** ''Requirements'': all data for the user is gathered: Name, Email, Subscription (verified, PayPal for now). This means that the user will be forwarded to PayPal, will subscribe, and then comes back to a page of ours - Recognition Page or a temporary page where he can fill out additional information (City, Country, ...) and after submitting these forwarded to the Recognition Page.
*** ''Effects'': the user is added as a True Fan, an embeddable badge is created for him, email notifications is sent to him containing a link to the recognition page.
*** ''Final State'': the user is logged in his Recognition Page

* Design considerations
** TODO by Alistair

===Recognition Page===
* Description
** If The True Fan is logged. Edit mode is available:
*** He sees his information and edit links for video, photo and text are available for clicking.
*** When he saves some information, he will be offered a link to the Share page.
** If it is not the True Fan who is logged, or it is an anonymous user:
*** The person sees the information the True Fan has saved.
*** Under that is the TF subscription.
*** There is a login link somewhere (top-right?), so that if this is the TF itself, he can login to his page.
* Transitions
** Share Page
*** ''Requirements'':
**** TF of the Recognition page should be logged
**** video or text should be filled out.
**** The TF clicks on the "Share page" link.
*** ''Effects'': no
*** ''Final State'': the TF is logged in the Share page.
* Design Considerations
** Add form inputs for user to link to their Twitter, Facebook accounts for use in sharing page.

===Share Page===
* Description
** If The True Fan is logged. Edit mode is available:
*** The TF writes the name, email of several of his friends, and clicking on each one of the added friends, he can add a personal video and text below. He can add/remove/edit friends and their data.
*** He can send the data either to one of his friends (maybe a button to the right of the email) or to all of them (asking for confirmation).
** If it is not the True Fan who is logged, or it is an anonymous user:
*** the page is not accessible.
* Transitions
** Share Page
*** ''Requirements'':
**** TF cliks on invite friend, or invite all friends.
*** ''Effects'':
**** a notifications appears that the friend/s was/were successfully invited.
**** an email is sent to every invited friend, containing a link to the "Invited Page".
**** a link is offered back to his Recognition Page. In this case he can just open it (this transition understandable and will not be described).
*** ''Final State'': the TF remains on the Share page.

===Invited Page===
* Description
** Everybody who has the link can access it, no difference between logged users and anonymous.
** Shows the invitation of the TF to his friend.
** Shows the TF subscription.
* Transitions
** Recognition Page
*** the same transition as in the True Fans Page

=Strategy=
==Video==
The videos can be
* youtube video (easy to program, time-intensive for the user)
* flash camera recorder (harder to program, quick to record for the user, lower quality)

We have the possibility of providing the user with two options:

# Past a link to a YoueTube video
# Record video from Flash and upload to YouTube using their developer API

If we rely on Option 2, we might bottleneck the development. It would make sense to build the functionality for Option 1 first and then begin working on a solution for Option 2 when the project is functionally complete.

Details of the YouTube's video uploads can be found here:
* http://code.google.com/apis/youtube/2.0/developers_guide_protocol.html#Uploading_Videos
* http://code.google.com/apis/youtube/2.0/developers_guide_protocol.html#Resumable_uploads

=Replication=

These are the steps required to replicate our implementation into another Drupal installation.

* Install the modules:
** [http://drupal.org/project/ckeditor CKEditor] - from the URL and extract the contents of from the [http://ckeditor.com/download download] in sites/all/modules/ckeditor/ckeditor .
** [http://drupal.org/project/media media]
** [http://drupal.org/project/media_youtube media_youtube]
** [http://drupal.org/project/media_vimeo media_vimeo]

=Tasks=

You can view the current tasks in the [https://www.pivotaltracker.com/projects/335285 Pivotal project].

==Badges==
* Check a demo for the embeddable badge: http://microfundingtest.openfarmtech.org/mywebsite.php
** Parameters:
*** id - true fan id
*** name - if equals 1, then displays the name of the True Fan above the badge, otherwise not.
** TODO - make secure reading of the URL parameters
* TODO - make a visualization of all OSE badges.

==PayPal==
* Jacob Roufa is trying to integrate PayPal into the registration process of Drupal 7 users: http://www.deerwalk.com/PayPal-Integration-with-Drupal-7
** TODO - still getting bugs
*** Using the [http://drupal.org/project/lm_paypal lm_paypal] module, a key function of the module (displaying the paypal button allowing users to subscribe to a role) is not working.
*** Block configuration found here : http://microfundingtest.openfarmtech.org/admin/structure/block/manage/block/1/configure (note: lm_paypal is currently disabled on the site)
*** Thread in Drupal.org project page issue queue here : http://drupal.org/node/733520
** Implementation without lm_paypal described in the Drupal Tasks section here : http://opensourceecology.org/wiki/OSE_Microfunding_Proposal/Implementation#Other_Drupal_tasks
==Paypal updates 6-27-11==
* Kelly Schutt completed basic Paypal integration. After completing the True Fan subscription payment, the user is automatically added to the True Fan role. We don't need an administrator to approve every account/payment this way.
** Overview of the Paypal subscription process
*** Custom microft module redirects user to Paypal for payment after registering account. Microft also passes custom_var to Paypal with Drupal User ID
*** Paypal connects to /paypalipn page and POSTs User ID variable. /paypalipn then save the user account with the additional True Fan role
**** Paypal should automatically redirect the user back to their profile page after payment, and the user should be logged in. Right now, the user has to click a button to be redirected and isn't automatically logged in.
* We still need to configure the registration process with a dropdown menu for different levels of True Fan support (e.g. $10/month vs $50/month)

==Design==
* Lukasz Jagodzinski is working on a Drupal theme, in an ose.org style and layout as definded in the wireframes.

==Other Drupal tasks==
* '''Show a text when certain fields are filled out'''
** We will need this for the Recognition page - when the video and text are filled out a text linking to the Share page should be displayed.
* '''True Fan status'''
** requested - a person has requested a True Fan status - An statusadmin should check whether there is a subscription by this
** true fan - the person is a True Fan
*** list of subscriptions - a True Fan can have more than one subscription, e.g. now $10, after few months $20.
*** from - the date of subscription
*** to - the date of unsubscription
*** amount - the amount of the subscription
* '''Configure Invite and User Relationships'''
** Allow users with the True Fan role to invite multiple friends
** Make sure the relationship shows between the invited and the invitee
*** Create a block using Views to show relationships
**** Make sure the block view uses arguments such that users are dynamic
**** Show block on Recognition, Share and Invited pages
** Note, Invite is still in -dev branch for D7. Module is working after applying patch found here : http://drupal.org/node/1054392#comment-4536388
* '''Create block to show all True Fans'''
** Show this block universally
** Block should just be list of True Fan users as their pictures
* '''Create block with PayPal button link to donate'''
** Show this block below main content on the True Fans page
** Block will show a standard PayPal button, let the user subscribe through PayPal and redirect him back to a Drupal user registration page. When he registers, he should have the status "True Fan Requested" (or similar) and an Administrator should approve it.
* '''Video embedding Support'''
** '''Enable Vimeo and others video providers for video embedding in Drupal 7'''
**'''Make quicker embedding of Videos in Drupal 7'''
*** Check this page: http://microfundingtest.openfarmtech.org/node/5
*** The user has to make 3 clicks for URL input - "Select media", "Web", "Submit". Can we make it with only 1?

=Team=

This is the Team working currently on the Proposal.

{| border="1"
|+ Microfunding IT Team
|-
! scope="col" | Name
! scope="col" | Current Tasks
! scope="col" | Finished Tasks
! scope="col" width="150" | Skills
! scope="col" width="150" | Commitment (DRC or part-time)
! scope="col" width="150" | Email
|-
| [[Nikolay Georgiev]] || create tasks || [http://microfundingtest.openfarmtech.org/mywebsite.php Embeddable Badge] || project manager and web programmer (intermediate PHP and MySQL skills, but no PHP Framework experience, good CSS and Javascript skills) || [[Dedicated Remote Collaboration]] || nikolay (at) opensourceecology.org
|-
| Jacob Roufa || PayPal integeration|| || Project Manager / Intermediate Developer : Drupal, CiviCRM, XHTML/HTML5, CSS, Javascript (jQuery library mostly), PHP, MySQL || DRC if available, part time if not || jacob.roufa@gmail.com
|-
| Eduardo Riesco || || || PHP, MySQL, PostgreSQL/PostGIS, CSS, Java, Drupal, CiviCRM, Joomla || part-time || eduardo.riesco (at) gmail (dot) com
|-
| Lukasz Jagodzinski || creating Drupal Theme || || PHP and Javascript || part-time ||
|-
| Kelly Schutt || || Blocks: OSE info, social sharing, Paypal integration || Graphic design, HTML/CSS, Drupal configuration, intermediate Javascript and PHP || part-time ||
|-
|}

OSE Microfunding Proposal/Implementation

2011-07-27T22:46:27Z

Kelly Schutt: /* Updates 6-27-11 from Kelly Schutt */

=Terminology=
Here is the common terminology:
* TF = True Fan

=Design=
==Wireframes==
The wireframes of the proposal were implemented in [http://www.lumzy.com/ Lumzy].

=Development=
==PHP CMS==
We chose Drupal.

==Drupal Environments==

* Drupal-test - http://microfundingtest.openfarmtech.org/ - used for development and testing
* Official Drupal - http://civicrm.opensourceecology.org/ - used for real

==Page Flow==

[[Image:Ose-microfunding-proposal-flow.png|600px]]

===True Fans Page===
* Description
** Showing motivational content about OSE, its importance, tangible outcome, etc.
** Allowing subscription.
* Transitions
** Recognition Page
*** ''Requirements'': all data for the user is gathered: Name, Email, Subscription (verified, PayPal for now). This means that the user will be forwarded to PayPal, will subscribe, and then comes back to a page of ours - Recognition Page or a temporary page where he can fill out additional information (City, Country, ...) and after submitting these forwarded to the Recognition Page.
*** ''Effects'': the user is added as a True Fan, an embeddable badge is created for him, email notifications is sent to him containing a link to the recognition page.
*** ''Final State'': the user is logged in his Recognition Page

* Design considerations
** TODO by Alistair

===Recognition Page===
* Description
** If The True Fan is logged. Edit mode is available:
*** He sees his information and edit links for video, photo and text are available for clicking.
*** When he saves some information, he will be offered a link to the Share page.
** If it is not the True Fan who is logged, or it is an anonymous user:
*** The person sees the information the True Fan has saved.
*** Under that is the TF subscription.
*** There is a login link somewhere (top-right?), so that if this is the TF itself, he can login to his page.
* Transitions
** Share Page
*** ''Requirements'':
**** TF of the Recognition page should be logged
**** video or text should be filled out.
**** The TF clicks on the "Share page" link.
*** ''Effects'': no
*** ''Final State'': the TF is logged in the Share page.
* Design Considerations
** Add form inputs for user to link to their Twitter, Facebook accounts for use in sharing page.

===Share Page===
* Description
** If The True Fan is logged. Edit mode is available:
*** The TF writes the name, email of several of his friends, and clicking on each one of the added friends, he can add a personal video and text below. He can add/remove/edit friends and their data.
*** He can send the data either to one of his friends (maybe a button to the right of the email) or to all of them (asking for confirmation).
** If it is not the True Fan who is logged, or it is an anonymous user:
*** the page is not accessible.
* Transitions
** Share Page
*** ''Requirements'':
**** TF cliks on invite friend, or invite all friends.
*** ''Effects'':
**** a notifications appears that the friend/s was/were successfully invited.
**** an email is sent to every invited friend, containing a link to the "Invited Page".
**** a link is offered back to his Recognition Page. In this case he can just open it (this transition understandable and will not be described).
*** ''Final State'': the TF remains on the Share page.

===Invited Page===
* Description
** Everybody who has the link can access it, no difference between logged users and anonymous.
** Shows the invitation of the TF to his friend.
** Shows the TF subscription.
* Transitions
** Recognition Page
*** the same transition as in the True Fans Page

=Strategy=
==Video==
The videos can be
* youtube video (easy to program, time-intensive for the user)
* flash camera recorder (harder to program, quick to record for the user, lower quality)

We have the possibility of providing the user with two options:

# Past a link to a YoueTube video
# Record video from Flash and upload to YouTube using their developer API

If we rely on Option 2, we might bottleneck the development. It would make sense to build the functionality for Option 1 first and then begin working on a solution for Option 2 when the project is functionally complete.

Details of the YouTube's video uploads can be found here:
* http://code.google.com/apis/youtube/2.0/developers_guide_protocol.html#Uploading_Videos
* http://code.google.com/apis/youtube/2.0/developers_guide_protocol.html#Resumable_uploads

=Replication=

These are the steps required to replicate our implementation into another Drupal installation.

* Install the modules:
** [http://drupal.org/project/ckeditor CKEditor] - from the URL and extract the contents of from the [http://ckeditor.com/download download] in sites/all/modules/ckeditor/ckeditor .
** [http://drupal.org/project/media media]
** [http://drupal.org/project/media_youtube media_youtube]
** [http://drupal.org/project/media_vimeo media_vimeo]

=Tasks=

You can view the current tasks in the [https://www.pivotaltracker.com/projects/335285 Pivotal project].

==Badges==
* Check a demo for the embeddable badge: http://microfundingtest.openfarmtech.org/mywebsite.php
** Parameters:
*** id - true fan id
*** name - if equals 1, then displays the name of the True Fan above the badge, otherwise not.
** TODO - make secure reading of the URL parameters
* TODO - make a visualization of all OSE badges.

==PayPal==
* Jacob Roufa is trying to integrate PayPal into the registration process of Drupal 7 users: http://www.deerwalk.com/PayPal-Integration-with-Drupal-7
** TODO - still getting bugs
*** Using the [http://drupal.org/project/lm_paypal lm_paypal] module, a key function of the module (displaying the paypal button allowing users to subscribe to a role) is not working.
*** Block configuration found here : http://microfundingtest.openfarmtech.org/admin/structure/block/manage/block/1/configure (note: lm_paypal is currently disabled on the site)
*** Thread in Drupal.org project page issue queue here : http://drupal.org/node/733520
** Implementation without lm_paypal described in the Drupal Tasks section here : http://opensourceecology.org/wiki/OSE_Microfunding_Proposal/Implementation#Other_Drupal_tasks
==Paypal updates 6-27-11 from Kelly Schutt==
* Kelly Schutt completed basic Paypal integration. After completing the True Fan subscription payment, the user is automatically added to the True Fan role. We don't need an administrator to approve every account/payment this way.
** Overview of the Paypal subscription process
*** Custom microft module redirects user to Paypal for payment after registering account. Microft also passes custom_var to Paypal with Drupal User ID
*** Paypal connects to /paypalipn page and POSTs User ID variable. /paypalipn then save the user account with the additional True Fan role
**** Paypal should automatically redirect the user back to their profile page after payment, and the user should be logged in. Right now, the user has to click a button to be redirected and isn't automatically logged in.
* We still need to configure the registration process with a dropdown menu for different levels of True Fan support (e.g. $10/month vs $50/month)

==Design==
* Lukasz Jagodzinski is working on a Drupal theme, in an ose.org style and layout as definded in the wireframes.

==Other Drupal tasks==
* '''Show a text when certain fields are filled out'''
** We will need this for the Recognition page - when the video and text are filled out a text linking to the Share page should be displayed.
* '''True Fan status'''
** requested - a person has requested a True Fan status - An statusadmin should check whether there is a subscription by this
** true fan - the person is a True Fan
*** list of subscriptions - a True Fan can have more than one subscription, e.g. now $10, after few months $20.
*** from - the date of subscription
*** to - the date of unsubscription
*** amount - the amount of the subscription
* '''Configure Invite and User Relationships'''
** Allow users with the True Fan role to invite multiple friends
** Make sure the relationship shows between the invited and the invitee
*** Create a block using Views to show relationships
**** Make sure the block view uses arguments such that users are dynamic
**** Show block on Recognition, Share and Invited pages
** Note, Invite is still in -dev branch for D7. Module is working after applying patch found here : http://drupal.org/node/1054392#comment-4536388
* '''Create block to show all True Fans'''
** Show this block universally
** Block should just be list of True Fan users as their pictures
* '''Create block with PayPal button link to donate'''
** Show this block below main content on the True Fans page
** Block will show a standard PayPal button, let the user subscribe through PayPal and redirect him back to a Drupal user registration page. When he registers, he should have the status "True Fan Requested" (or similar) and an Administrator should approve it.
* '''Video embedding Support'''
** '''Enable Vimeo and others video providers for video embedding in Drupal 7'''
**'''Make quicker embedding of Videos in Drupal 7'''
*** Check this page: http://microfundingtest.openfarmtech.org/node/5
*** The user has to make 3 clicks for URL input - "Select media", "Web", "Submit". Can we make it with only 1?

=Team=

This is the Team working currently on the Proposal.

{| border="1"
|+ Microfunding IT Team
|-
! scope="col" | Name
! scope="col" | Current Tasks
! scope="col" | Finished Tasks
! scope="col" width="150" | Skills
! scope="col" width="150" | Commitment (DRC or part-time)
! scope="col" width="150" | Email
|-
| [[Nikolay Georgiev]] || create tasks || [http://microfundingtest.openfarmtech.org/mywebsite.php Embeddable Badge] || project manager and web programmer (intermediate PHP and MySQL skills, but no PHP Framework experience, good CSS and Javascript skills) || [[Dedicated Remote Collaboration]] || nikolay (at) opensourceecology.org
|-
| Jacob Roufa || PayPal integeration|| || Project Manager / Intermediate Developer : Drupal, CiviCRM, XHTML/HTML5, CSS, Javascript (jQuery library mostly), PHP, MySQL || DRC if available, part time if not || jacob.roufa@gmail.com
|-
| Eduardo Riesco || || || PHP, MySQL, PostgreSQL/PostGIS, CSS, Java, Drupal, CiviCRM, Joomla || part-time || eduardo.riesco (at) gmail (dot) com
|-
| Lukasz Jagodzinski || creating Drupal Theme || || PHP and Javascript || part-time ||
|-
| Kelly Schutt || || Blocks: OSE info, social sharing, Paypal integration || Graphic design, HTML/CSS, Drupal configuration, intermediate Javascript and PHP || part-time ||
|-
|}

OSE Microfunding Proposal/Implementation

2011-07-27T22:46:09Z

Kelly Schutt: /* PayPal */

=Terminology=
Here is the common terminology:
* TF = True Fan

=Design=
==Wireframes==
The wireframes of the proposal were implemented in [http://www.lumzy.com/ Lumzy].

=Development=
==PHP CMS==
We chose Drupal.

==Drupal Environments==

* Drupal-test - http://microfundingtest.openfarmtech.org/ - used for development and testing
* Official Drupal - http://civicrm.opensourceecology.org/ - used for real

==Page Flow==

[[Image:Ose-microfunding-proposal-flow.png|600px]]

===True Fans Page===
* Description
** Showing motivational content about OSE, its importance, tangible outcome, etc.
** Allowing subscription.
* Transitions
** Recognition Page
*** ''Requirements'': all data for the user is gathered: Name, Email, Subscription (verified, PayPal for now). This means that the user will be forwarded to PayPal, will subscribe, and then comes back to a page of ours - Recognition Page or a temporary page where he can fill out additional information (City, Country, ...) and after submitting these forwarded to the Recognition Page.
*** ''Effects'': the user is added as a True Fan, an embeddable badge is created for him, email notifications is sent to him containing a link to the recognition page.
*** ''Final State'': the user is logged in his Recognition Page

* Design considerations
** TODO by Alistair

===Recognition Page===
* Description
** If The True Fan is logged. Edit mode is available:
*** He sees his information and edit links for video, photo and text are available for clicking.
*** When he saves some information, he will be offered a link to the Share page.
** If it is not the True Fan who is logged, or it is an anonymous user:
*** The person sees the information the True Fan has saved.
*** Under that is the TF subscription.
*** There is a login link somewhere (top-right?), so that if this is the TF itself, he can login to his page.
* Transitions
** Share Page
*** ''Requirements'':
**** TF of the Recognition page should be logged
**** video or text should be filled out.
**** The TF clicks on the "Share page" link.
*** ''Effects'': no
*** ''Final State'': the TF is logged in the Share page.
* Design Considerations
** Add form inputs for user to link to their Twitter, Facebook accounts for use in sharing page.

===Share Page===
* Description
** If The True Fan is logged. Edit mode is available:
*** The TF writes the name, email of several of his friends, and clicking on each one of the added friends, he can add a personal video and text below. He can add/remove/edit friends and their data.
*** He can send the data either to one of his friends (maybe a button to the right of the email) or to all of them (asking for confirmation).
** If it is not the True Fan who is logged, or it is an anonymous user:
*** the page is not accessible.
* Transitions
** Share Page
*** ''Requirements'':
**** TF cliks on invite friend, or invite all friends.
*** ''Effects'':
**** a notifications appears that the friend/s was/were successfully invited.
**** an email is sent to every invited friend, containing a link to the "Invited Page".
**** a link is offered back to his Recognition Page. In this case he can just open it (this transition understandable and will not be described).
*** ''Final State'': the TF remains on the Share page.

===Invited Page===
* Description
** Everybody who has the link can access it, no difference between logged users and anonymous.
** Shows the invitation of the TF to his friend.
** Shows the TF subscription.
* Transitions
** Recognition Page
*** the same transition as in the True Fans Page

=Strategy=
==Video==
The videos can be
* youtube video (easy to program, time-intensive for the user)
* flash camera recorder (harder to program, quick to record for the user, lower quality)

We have the possibility of providing the user with two options:

# Past a link to a YoueTube video
# Record video from Flash and upload to YouTube using their developer API

If we rely on Option 2, we might bottleneck the development. It would make sense to build the functionality for Option 1 first and then begin working on a solution for Option 2 when the project is functionally complete.

Details of the YouTube's video uploads can be found here:
* http://code.google.com/apis/youtube/2.0/developers_guide_protocol.html#Uploading_Videos
* http://code.google.com/apis/youtube/2.0/developers_guide_protocol.html#Resumable_uploads

=Replication=

These are the steps required to replicate our implementation into another Drupal installation.

* Install the modules:
** [http://drupal.org/project/ckeditor CKEditor] - from the URL and extract the contents of from the [http://ckeditor.com/download download] in sites/all/modules/ckeditor/ckeditor .
** [http://drupal.org/project/media media]
** [http://drupal.org/project/media_youtube media_youtube]
** [http://drupal.org/project/media_vimeo media_vimeo]

=Tasks=

You can view the current tasks in the [https://www.pivotaltracker.com/projects/335285 Pivotal project].

==Badges==
* Check a demo for the embeddable badge: http://microfundingtest.openfarmtech.org/mywebsite.php
** Parameters:
*** id - true fan id
*** name - if equals 1, then displays the name of the True Fan above the badge, otherwise not.
** TODO - make secure reading of the URL parameters
* TODO - make a visualization of all OSE badges.

==PayPal==
* Jacob Roufa is trying to integrate PayPal into the registration process of Drupal 7 users: http://www.deerwalk.com/PayPal-Integration-with-Drupal-7
** TODO - still getting bugs
*** Using the [http://drupal.org/project/lm_paypal lm_paypal] module, a key function of the module (displaying the paypal button allowing users to subscribe to a role) is not working.
*** Block configuration found here : http://microfundingtest.openfarmtech.org/admin/structure/block/manage/block/1/configure (note: lm_paypal is currently disabled on the site)
*** Thread in Drupal.org project page issue queue here : http://drupal.org/node/733520
** Implementation without lm_paypal described in the Drupal Tasks section here : http://opensourceecology.org/wiki/OSE_Microfunding_Proposal/Implementation#Other_Drupal_tasks
==Updates 6-27-11 from Kelly Schutt==
* Kelly Schutt completed basic Paypal integration. After completing the True Fan subscription payment, the user is automatically added to the True Fan role. We don't need an administrator to approve every account/payment this way.
** Overview of the Paypal subscription process
*** Custom microft module redirects user to Paypal for payment after registering account. Microft also passes custom_var to Paypal with Drupal User ID
*** Paypal connects to /paypalipn page and POSTs User ID variable. /paypalipn then save the user account with the additional True Fan role
**** Paypal should automatically redirect the user back to their profile page after payment, and the user should be logged in. Right now, the user has to click a button to be redirected and isn't automatically logged in.
* We still need to configure the registration process with a dropdown menu for different levels of True Fan support (e.g. $10/month vs $50/month)

==Design==
* Lukasz Jagodzinski is working on a Drupal theme, in an ose.org style and layout as definded in the wireframes.

==Other Drupal tasks==
* '''Show a text when certain fields are filled out'''
** We will need this for the Recognition page - when the video and text are filled out a text linking to the Share page should be displayed.
* '''True Fan status'''
** requested - a person has requested a True Fan status - An statusadmin should check whether there is a subscription by this
** true fan - the person is a True Fan
*** list of subscriptions - a True Fan can have more than one subscription, e.g. now $10, after few months $20.
*** from - the date of subscription
*** to - the date of unsubscription
*** amount - the amount of the subscription
* '''Configure Invite and User Relationships'''
** Allow users with the True Fan role to invite multiple friends
** Make sure the relationship shows between the invited and the invitee
*** Create a block using Views to show relationships
**** Make sure the block view uses arguments such that users are dynamic
**** Show block on Recognition, Share and Invited pages
** Note, Invite is still in -dev branch for D7. Module is working after applying patch found here : http://drupal.org/node/1054392#comment-4536388
* '''Create block to show all True Fans'''
** Show this block universally
** Block should just be list of True Fan users as their pictures
* '''Create block with PayPal button link to donate'''
** Show this block below main content on the True Fans page
** Block will show a standard PayPal button, let the user subscribe through PayPal and redirect him back to a Drupal user registration page. When he registers, he should have the status "True Fan Requested" (or similar) and an Administrator should approve it.
* '''Video embedding Support'''
** '''Enable Vimeo and others video providers for video embedding in Drupal 7'''
**'''Make quicker embedding of Videos in Drupal 7'''
*** Check this page: http://microfundingtest.openfarmtech.org/node/5
*** The user has to make 3 clicks for URL input - "Select media", "Web", "Submit". Can we make it with only 1?

=Team=

This is the Team working currently on the Proposal.

{| border="1"
|+ Microfunding IT Team
|-
! scope="col" | Name
! scope="col" | Current Tasks
! scope="col" | Finished Tasks
! scope="col" width="150" | Skills
! scope="col" width="150" | Commitment (DRC or part-time)
! scope="col" width="150" | Email
|-
| [[Nikolay Georgiev]] || create tasks || [http://microfundingtest.openfarmtech.org/mywebsite.php Embeddable Badge] || project manager and web programmer (intermediate PHP and MySQL skills, but no PHP Framework experience, good CSS and Javascript skills) || [[Dedicated Remote Collaboration]] || nikolay (at) opensourceecology.org
|-
| Jacob Roufa || PayPal integeration|| || Project Manager / Intermediate Developer : Drupal, CiviCRM, XHTML/HTML5, CSS, Javascript (jQuery library mostly), PHP, MySQL || DRC if available, part time if not || jacob.roufa@gmail.com
|-
| Eduardo Riesco || || || PHP, MySQL, PostgreSQL/PostGIS, CSS, Java, Drupal, CiviCRM, Joomla || part-time || eduardo.riesco (at) gmail (dot) com
|-
| Lukasz Jagodzinski || creating Drupal Theme || || PHP and Javascript || part-time ||
|-
| Kelly Schutt || || Blocks: OSE info, social sharing, Paypal integration || Graphic design, HTML/CSS, Drupal configuration, intermediate Javascript and PHP || part-time ||
|-
|}

OSE Microfunding Proposal/Implementation

2011-07-27T22:43:30Z

Kelly Schutt: /* PayPal */

=Terminology=
Here is the common terminology:
* TF = True Fan

=Design=
==Wireframes==
The wireframes of the proposal were implemented in [http://www.lumzy.com/ Lumzy].

=Development=
==PHP CMS==
We chose Drupal.

==Drupal Environments==

* Drupal-test - http://microfundingtest.openfarmtech.org/ - used for development and testing
* Official Drupal - http://civicrm.opensourceecology.org/ - used for real

==Page Flow==

[[Image:Ose-microfunding-proposal-flow.png|600px]]

===True Fans Page===
* Description
** Showing motivational content about OSE, its importance, tangible outcome, etc.
** Allowing subscription.
* Transitions
** Recognition Page
*** ''Requirements'': all data for the user is gathered: Name, Email, Subscription (verified, PayPal for now). This means that the user will be forwarded to PayPal, will subscribe, and then comes back to a page of ours - Recognition Page or a temporary page where he can fill out additional information (City, Country, ...) and after submitting these forwarded to the Recognition Page.
*** ''Effects'': the user is added as a True Fan, an embeddable badge is created for him, email notifications is sent to him containing a link to the recognition page.
*** ''Final State'': the user is logged in his Recognition Page

* Design considerations
** TODO by Alistair

===Recognition Page===
* Description
** If The True Fan is logged. Edit mode is available:
*** He sees his information and edit links for video, photo and text are available for clicking.
*** When he saves some information, he will be offered a link to the Share page.
** If it is not the True Fan who is logged, or it is an anonymous user:
*** The person sees the information the True Fan has saved.
*** Under that is the TF subscription.
*** There is a login link somewhere (top-right?), so that if this is the TF itself, he can login to his page.
* Transitions
** Share Page
*** ''Requirements'':
**** TF of the Recognition page should be logged
**** video or text should be filled out.
**** The TF clicks on the "Share page" link.
*** ''Effects'': no
*** ''Final State'': the TF is logged in the Share page.
* Design Considerations
** Add form inputs for user to link to their Twitter, Facebook accounts for use in sharing page.

===Share Page===
* Description
** If The True Fan is logged. Edit mode is available:
*** The TF writes the name, email of several of his friends, and clicking on each one of the added friends, he can add a personal video and text below. He can add/remove/edit friends and their data.
*** He can send the data either to one of his friends (maybe a button to the right of the email) or to all of them (asking for confirmation).
** If it is not the True Fan who is logged, or it is an anonymous user:
*** the page is not accessible.
* Transitions
** Share Page
*** ''Requirements'':
**** TF cliks on invite friend, or invite all friends.
*** ''Effects'':
**** a notifications appears that the friend/s was/were successfully invited.
**** an email is sent to every invited friend, containing a link to the "Invited Page".
**** a link is offered back to his Recognition Page. In this case he can just open it (this transition understandable and will not be described).
*** ''Final State'': the TF remains on the Share page.

===Invited Page===
* Description
** Everybody who has the link can access it, no difference between logged users and anonymous.
** Shows the invitation of the TF to his friend.
** Shows the TF subscription.
* Transitions
** Recognition Page
*** the same transition as in the True Fans Page

=Strategy=
==Video==
The videos can be
* youtube video (easy to program, time-intensive for the user)
* flash camera recorder (harder to program, quick to record for the user, lower quality)

We have the possibility of providing the user with two options:

# Past a link to a YoueTube video
# Record video from Flash and upload to YouTube using their developer API

If we rely on Option 2, we might bottleneck the development. It would make sense to build the functionality for Option 1 first and then begin working on a solution for Option 2 when the project is functionally complete.

Details of the YouTube's video uploads can be found here:
* http://code.google.com/apis/youtube/2.0/developers_guide_protocol.html#Uploading_Videos
* http://code.google.com/apis/youtube/2.0/developers_guide_protocol.html#Resumable_uploads

=Replication=

These are the steps required to replicate our implementation into another Drupal installation.

* Install the modules:
** [http://drupal.org/project/ckeditor CKEditor] - from the URL and extract the contents of from the [http://ckeditor.com/download download] in sites/all/modules/ckeditor/ckeditor .
** [http://drupal.org/project/media media]
** [http://drupal.org/project/media_youtube media_youtube]
** [http://drupal.org/project/media_vimeo media_vimeo]

=Tasks=

You can view the current tasks in the [https://www.pivotaltracker.com/projects/335285 Pivotal project].

==Badges==
* Check a demo for the embeddable badge: http://microfundingtest.openfarmtech.org/mywebsite.php
** Parameters:
*** id - true fan id
*** name - if equals 1, then displays the name of the True Fan above the badge, otherwise not.
** TODO - make secure reading of the URL parameters
* TODO - make a visualization of all OSE badges.

==PayPal==
* Jacob Roufa is trying to integrate PayPal into the registration process of Drupal 7 users: http://www.deerwalk.com/PayPal-Integration-with-Drupal-7
** TODO - still getting bugs
*** Using the [http://drupal.org/project/lm_paypal lm_paypal] module, a key function of the module (displaying the paypal button allowing users to subscribe to a role) is not working.
*** Block configuration found here : http://microfundingtest.openfarmtech.org/admin/structure/block/manage/block/1/configure (note: lm_paypal is currently disabled on the site)
*** Thread in Drupal.org project page issue queue here : http://drupal.org/node/733520
** Implementation without lm_paypal described in the Drupal Tasks section here : http://opensourceecology.org/wiki/OSE_Microfunding_Proposal/Implementation#Other_Drupal_tasks
* Kelly Schutt completed basic Paypal integration. After completing the True Fan subscription payment, the user is automatically added to the True Fan role. We don't need an administrator to approve every account/payment this way.
* We still need to configure the registration process with a dropdown menu for different levels of True Fan support (e.g. $10/month vs $50/month)

==Design==
* Lukasz Jagodzinski is working on a Drupal theme, in an ose.org style and layout as definded in the wireframes.

==Other Drupal tasks==
* '''Show a text when certain fields are filled out'''
** We will need this for the Recognition page - when the video and text are filled out a text linking to the Share page should be displayed.
* '''True Fan status'''
** requested - a person has requested a True Fan status - An statusadmin should check whether there is a subscription by this
** true fan - the person is a True Fan
*** list of subscriptions - a True Fan can have more than one subscription, e.g. now $10, after few months $20.
*** from - the date of subscription
*** to - the date of unsubscription
*** amount - the amount of the subscription
* '''Configure Invite and User Relationships'''
** Allow users with the True Fan role to invite multiple friends
** Make sure the relationship shows between the invited and the invitee
*** Create a block using Views to show relationships
**** Make sure the block view uses arguments such that users are dynamic
**** Show block on Recognition, Share and Invited pages
** Note, Invite is still in -dev branch for D7. Module is working after applying patch found here : http://drupal.org/node/1054392#comment-4536388
* '''Create block to show all True Fans'''
** Show this block universally
** Block should just be list of True Fan users as their pictures
* '''Create block with PayPal button link to donate'''
** Show this block below main content on the True Fans page
** Block will show a standard PayPal button, let the user subscribe through PayPal and redirect him back to a Drupal user registration page. When he registers, he should have the status "True Fan Requested" (or similar) and an Administrator should approve it.
* '''Video embedding Support'''
** '''Enable Vimeo and others video providers for video embedding in Drupal 7'''
**'''Make quicker embedding of Videos in Drupal 7'''
*** Check this page: http://microfundingtest.openfarmtech.org/node/5
*** The user has to make 3 clicks for URL input - "Select media", "Web", "Submit". Can we make it with only 1?

=Team=

This is the Team working currently on the Proposal.

{| border="1"
|+ Microfunding IT Team
|-
! scope="col" | Name
! scope="col" | Current Tasks
! scope="col" | Finished Tasks
! scope="col" width="150" | Skills
! scope="col" width="150" | Commitment (DRC or part-time)
! scope="col" width="150" | Email
|-
| [[Nikolay Georgiev]] || create tasks || [http://microfundingtest.openfarmtech.org/mywebsite.php Embeddable Badge] || project manager and web programmer (intermediate PHP and MySQL skills, but no PHP Framework experience, good CSS and Javascript skills) || [[Dedicated Remote Collaboration]] || nikolay (at) opensourceecology.org
|-
| Jacob Roufa || PayPal integeration|| || Project Manager / Intermediate Developer : Drupal, CiviCRM, XHTML/HTML5, CSS, Javascript (jQuery library mostly), PHP, MySQL || DRC if available, part time if not || jacob.roufa@gmail.com
|-
| Eduardo Riesco || || || PHP, MySQL, PostgreSQL/PostGIS, CSS, Java, Drupal, CiviCRM, Joomla || part-time || eduardo.riesco (at) gmail (dot) com
|-
| Lukasz Jagodzinski || creating Drupal Theme || || PHP and Javascript || part-time ||
|-
| Kelly Schutt || || Blocks: OSE info, social sharing, Paypal integration || Graphic design, HTML/CSS, Drupal configuration, intermediate Javascript and PHP || part-time ||
|-
|}

OSE Microfunding Proposal/Implementation

2011-07-27T22:41:48Z

Kelly Schutt: /* Team */

=Terminology=
Here is the common terminology:
* TF = True Fan

=Design=
==Wireframes==
The wireframes of the proposal were implemented in [http://www.lumzy.com/ Lumzy].

=Development=
==PHP CMS==
We chose Drupal.

==Drupal Environments==

* Drupal-test - http://microfundingtest.openfarmtech.org/ - used for development and testing
* Official Drupal - http://civicrm.opensourceecology.org/ - used for real

==Page Flow==

[[Image:Ose-microfunding-proposal-flow.png|600px]]

===True Fans Page===
* Description
** Showing motivational content about OSE, its importance, tangible outcome, etc.
** Allowing subscription.
* Transitions
** Recognition Page
*** ''Requirements'': all data for the user is gathered: Name, Email, Subscription (verified, PayPal for now). This means that the user will be forwarded to PayPal, will subscribe, and then comes back to a page of ours - Recognition Page or a temporary page where he can fill out additional information (City, Country, ...) and after submitting these forwarded to the Recognition Page.
*** ''Effects'': the user is added as a True Fan, an embeddable badge is created for him, email notifications is sent to him containing a link to the recognition page.
*** ''Final State'': the user is logged in his Recognition Page

* Design considerations
** TODO by Alistair

===Recognition Page===
* Description
** If The True Fan is logged. Edit mode is available:
*** He sees his information and edit links for video, photo and text are available for clicking.
*** When he saves some information, he will be offered a link to the Share page.
** If it is not the True Fan who is logged, or it is an anonymous user:
*** The person sees the information the True Fan has saved.
*** Under that is the TF subscription.
*** There is a login link somewhere (top-right?), so that if this is the TF itself, he can login to his page.
* Transitions
** Share Page
*** ''Requirements'':
**** TF of the Recognition page should be logged
**** video or text should be filled out.
**** The TF clicks on the "Share page" link.
*** ''Effects'': no
*** ''Final State'': the TF is logged in the Share page.
* Design Considerations
** Add form inputs for user to link to their Twitter, Facebook accounts for use in sharing page.

===Share Page===
* Description
** If The True Fan is logged. Edit mode is available:
*** The TF writes the name, email of several of his friends, and clicking on each one of the added friends, he can add a personal video and text below. He can add/remove/edit friends and their data.
*** He can send the data either to one of his friends (maybe a button to the right of the email) or to all of them (asking for confirmation).
** If it is not the True Fan who is logged, or it is an anonymous user:
*** the page is not accessible.
* Transitions
** Share Page
*** ''Requirements'':
**** TF cliks on invite friend, or invite all friends.
*** ''Effects'':
**** a notifications appears that the friend/s was/were successfully invited.
**** an email is sent to every invited friend, containing a link to the "Invited Page".
**** a link is offered back to his Recognition Page. In this case he can just open it (this transition understandable and will not be described).
*** ''Final State'': the TF remains on the Share page.

===Invited Page===
* Description
** Everybody who has the link can access it, no difference between logged users and anonymous.
** Shows the invitation of the TF to his friend.
** Shows the TF subscription.
* Transitions
** Recognition Page
*** the same transition as in the True Fans Page

=Strategy=
==Video==
The videos can be
* youtube video (easy to program, time-intensive for the user)
* flash camera recorder (harder to program, quick to record for the user, lower quality)

We have the possibility of providing the user with two options:

# Past a link to a YoueTube video
# Record video from Flash and upload to YouTube using their developer API

If we rely on Option 2, we might bottleneck the development. It would make sense to build the functionality for Option 1 first and then begin working on a solution for Option 2 when the project is functionally complete.

Details of the YouTube's video uploads can be found here:
* http://code.google.com/apis/youtube/2.0/developers_guide_protocol.html#Uploading_Videos
* http://code.google.com/apis/youtube/2.0/developers_guide_protocol.html#Resumable_uploads

=Replication=

These are the steps required to replicate our implementation into another Drupal installation.

* Install the modules:
** [http://drupal.org/project/ckeditor CKEditor] - from the URL and extract the contents of from the [http://ckeditor.com/download download] in sites/all/modules/ckeditor/ckeditor .
** [http://drupal.org/project/media media]
** [http://drupal.org/project/media_youtube media_youtube]
** [http://drupal.org/project/media_vimeo media_vimeo]

=Tasks=

You can view the current tasks in the [https://www.pivotaltracker.com/projects/335285 Pivotal project].

==Badges==
* Check a demo for the embeddable badge: http://microfundingtest.openfarmtech.org/mywebsite.php
** Parameters:
*** id - true fan id
*** name - if equals 1, then displays the name of the True Fan above the badge, otherwise not.
** TODO - make secure reading of the URL parameters
* TODO - make a visualization of all OSE badges.

==PayPal==
* Jacob Roufa is trying to integrate PayPal into the registration process of Drupal 7 users: http://www.deerwalk.com/PayPal-Integration-with-Drupal-7
** TODO - still getting bugs
*** Using the [http://drupal.org/project/lm_paypal lm_paypal] module, a key function of the module (displaying the paypal button allowing users to subscribe to a role) is not working.
*** Block configuration found here : http://microfundingtest.openfarmtech.org/admin/structure/block/manage/block/1/configure (note: lm_paypal is currently disabled on the site)
*** Thread in Drupal.org project page issue queue here : http://drupal.org/node/733520
** Implementation without lm_paypal described in the Drupal Tasks section here : http://opensourceecology.org/wiki/OSE_Microfunding_Proposal/Implementation#Other_Drupal_tasks

==Design==
* Lukasz Jagodzinski is working on a Drupal theme, in an ose.org style and layout as definded in the wireframes.

==Other Drupal tasks==
* '''Show a text when certain fields are filled out'''
** We will need this for the Recognition page - when the video and text are filled out a text linking to the Share page should be displayed.
* '''True Fan status'''
** requested - a person has requested a True Fan status - An statusadmin should check whether there is a subscription by this
** true fan - the person is a True Fan
*** list of subscriptions - a True Fan can have more than one subscription, e.g. now $10, after few months $20.
*** from - the date of subscription
*** to - the date of unsubscription
*** amount - the amount of the subscription
* '''Configure Invite and User Relationships'''
** Allow users with the True Fan role to invite multiple friends
** Make sure the relationship shows between the invited and the invitee
*** Create a block using Views to show relationships
**** Make sure the block view uses arguments such that users are dynamic
**** Show block on Recognition, Share and Invited pages
** Note, Invite is still in -dev branch for D7. Module is working after applying patch found here : http://drupal.org/node/1054392#comment-4536388
* '''Create block to show all True Fans'''
** Show this block universally
** Block should just be list of True Fan users as their pictures
* '''Create block with PayPal button link to donate'''
** Show this block below main content on the True Fans page
** Block will show a standard PayPal button, let the user subscribe through PayPal and redirect him back to a Drupal user registration page. When he registers, he should have the status "True Fan Requested" (or similar) and an Administrator should approve it.
* '''Video embedding Support'''
** '''Enable Vimeo and others video providers for video embedding in Drupal 7'''
**'''Make quicker embedding of Videos in Drupal 7'''
*** Check this page: http://microfundingtest.openfarmtech.org/node/5
*** The user has to make 3 clicks for URL input - "Select media", "Web", "Submit". Can we make it with only 1?

=Team=

This is the Team working currently on the Proposal.

{| border="1"
|+ Microfunding IT Team
|-
! scope="col" | Name
! scope="col" | Current Tasks
! scope="col" | Finished Tasks
! scope="col" width="150" | Skills
! scope="col" width="150" | Commitment (DRC or part-time)
! scope="col" width="150" | Email
|-
| [[Nikolay Georgiev]] || create tasks || [http://microfundingtest.openfarmtech.org/mywebsite.php Embeddable Badge] || project manager and web programmer (intermediate PHP and MySQL skills, but no PHP Framework experience, good CSS and Javascript skills) || [[Dedicated Remote Collaboration]] || nikolay (at) opensourceecology.org
|-
| Jacob Roufa || PayPal integeration|| || Project Manager / Intermediate Developer : Drupal, CiviCRM, XHTML/HTML5, CSS, Javascript (jQuery library mostly), PHP, MySQL || DRC if available, part time if not || jacob.roufa@gmail.com
|-
| Eduardo Riesco || || || PHP, MySQL, PostgreSQL/PostGIS, CSS, Java, Drupal, CiviCRM, Joomla || part-time || eduardo.riesco (at) gmail (dot) com
|-
| Lukasz Jagodzinski || creating Drupal Theme || || PHP and Javascript || part-time ||
|-
| Kelly Schutt || || Blocks: OSE info, social sharing, Paypal integration || Graphic design, HTML/CSS, Drupal configuration, intermediate Javascript and PHP || part-time ||
|-
|}

OSE Microfunding Proposal/Implementation

2011-07-24T22:21:41Z

Kelly Schutt: /* Team */

=Terminology=
Here is the common terminology:
* TF = True Fan

=Design=
==Wireframes==
The wireframes of the proposal were implemented in [http://www.lumzy.com/ Lumzy].

=Development=
==PHP CMS==
We chose Drupal.

==Drupal Environments==

* Drupal-test - http://microfundingtest.openfarmtech.org/ - used for development and testing
* Official Drupal - http://civicrm.opensourceecology.org/ - used for real

==Page Flow==

[[Image:Ose-microfunding-proposal-flow.png|600px]]

===True Fans Page===
* Description
** Showing motivational content about OSE, its importance, tangible outcome, etc.
** Allowing subscription.
* Transitions
** Recognition Page
*** ''Requirements'': all data for the user is gathered: Name, Email, Subscription (verified, PayPal for now). This means that the user will be forwarded to PayPal, will subscribe, and then comes back to a page of ours - Recognition Page or a temporary page where he can fill out additional information (City, Country, ...) and after submitting these forwarded to the Recognition Page.
*** ''Effects'': the user is added as a True Fan, an embeddable badge is created for him, email notifications is sent to him containing a link to the recognition page.
*** ''Final State'': the user is logged in his Recognition Page

* Design considerations
** TODO by Alistair

===Recognition Page===
* Description
** If The True Fan is logged. Edit mode is available:
*** He sees his information and edit links for video, photo and text are available for clicking.
*** When he saves some information, he will be offered a link to the Share page.
** If it is not the True Fan who is logged, or it is an anonymous user:
*** The person sees the information the True Fan has saved.
*** Under that is the TF subscription.
*** There is a login link somewhere (top-right?), so that if this is the TF itself, he can login to his page.
* Transitions
** Share Page
*** ''Requirements'':
**** TF of the Recognition page should be logged
**** video or text should be filled out.
**** The TF clicks on the "Share page" link.
*** ''Effects'': no
*** ''Final State'': the TF is logged in the Share page.
* Design Considerations
** Add form inputs for user to link to their Twitter, Facebook accounts for use in sharing page.

===Share Page===
* Description
** If The True Fan is logged. Edit mode is available:
*** The TF writes the name, email of several of his friends, and clicking on each one of the added friends, he can add a personal video and text below. He can add/remove/edit friends and their data.
*** He can send the data either to one of his friends (maybe a button to the right of the email) or to all of them (asking for confirmation).
** If it is not the True Fan who is logged, or it is an anonymous user:
*** the page is not accessible.
* Transitions
** Share Page
*** ''Requirements'':
**** TF cliks on invite friend, or invite all friends.
*** ''Effects'':
**** a notifications appears that the friend/s was/were successfully invited.
**** an email is sent to every invited friend, containing a link to the "Invited Page".
**** a link is offered back to his Recognition Page. In this case he can just open it (this transition understandable and will not be described).
*** ''Final State'': the TF remains on the Share page.

===Invited Page===
* Description
** Everybody who has the link can access it, no difference between logged users and anonymous.
** Shows the invitation of the TF to his friend.
** Shows the TF subscription.
* Transitions
** Recognition Page
*** the same transition as in the True Fans Page

=Strategy=
==Video==
The videos can be
* youtube video (easy to program, time-intensive for the user)
* flash camera recorder (harder to program, quick to record for the user, lower quality)

We have the possibility of providing the user with two options:

# Past a link to a YoueTube video
# Record video from Flash and upload to YouTube using their developer API

If we rely on Option 2, we might bottleneck the development. It would make sense to build the functionality for Option 1 first and then begin working on a solution for Option 2 when the project is functionally complete.

Details of the YouTube's video uploads can be found here:
* http://code.google.com/apis/youtube/2.0/developers_guide_protocol.html#Uploading_Videos
* http://code.google.com/apis/youtube/2.0/developers_guide_protocol.html#Resumable_uploads

=Tasks=

You can view the current tasks in the [https://www.pivotaltracker.com/projects/335285 Pivotal project].

==Badges==
* Check a demo for the embeddable badge: http://microfundingtest.openfarmtech.org/mywebsite.php
** Parameters:
*** id - true fan id
*** name - if equals 1, then displays the name of the True Fan above the badge, otherwise not.
** TODO - make secure reading of the URL parameters
* TODO - make a visualization of all OSE badges.

==PayPal==
* Jacob Roufa is trying to integrate PayPal into the registration process of Drupal 7 users: http://www.deerwalk.com/PayPal-Integration-with-Drupal-7
** TODO - still getting bugs
*** Using the [http://drupal.org/project/lm_paypal lm_paypal] module, a key function of the module (displaying the paypal button allowing users to subscribe to a role) is not working.
*** Block configuration found here : http://microfundingtest.openfarmtech.org/admin/structure/block/manage/block/1/configure (note: lm_paypal is currently disabled on the site)
*** Thread in Drupal.org project page issue queue here : http://drupal.org/node/733520
** Implementation without lm_paypal described in the Drupal Tasks section here : http://opensourceecology.org/wiki/OSE_Microfunding_Proposal/Implementation#Other_Drupal_tasks

==Design==
* Alistair MacDonald and Lukasz Jagodzinski are working on a Drupal theme, in an ose.org style and layout as definded in the wireframes.

==Other Drupal tasks==
* '''Show a text when certain fields are filled out'''
** We will need this for the Recognition page - when the video and text are filled out a text linking to the Share page should be displayed.
* '''True Fan status'''
** requested - a person has requested a True Fan status - An statusadmin should check whether there is a subscription by this
** true fan - the person is a True Fan
*** list of subscriptions - a True Fan can have more than one subscription, e.g. now $10, after few months $20.
*** from - the date of subscription
*** to - the date of unsubscription
*** amount - the amount of the subscription
* '''Configure Invite and User Relationships'''
** Allow users with the True Fan role to invite multiple friends
** Make sure the relationship shows between the invited and the invitee
*** Create a block using Views to show relationships
**** Make sure the block view uses arguments such that users are dynamic
**** Show block on Recognition, Share and Invited pages
** Note, Invite is still in -dev branch for D7. Module is working after applying patch found here : http://drupal.org/node/1054392#comment-4536388
* '''Create block to show all True Fans'''
** Show this block universally
** Block should just be list of True Fan users as their pictures
* '''Create block with PayPal button link to donate'''
** Show this block below main content on the True Fans page
** Block will show a standard PayPal button, let the user subscribe through PayPal and redirect him back to a Drupal user registration page. When he registers, he should have the status "True Fan Requested" (or similar) and an Administrator should approve it.

=Team=

This is the Team working currently on the Proposal.

{| border="1"
|+ Microfunding IT Team
|-
! scope="col" | Name
! scope="col" | Current Tasks
! scope="col" | Finished Tasks
! scope="col" width="150" | Skills
! scope="col" width="150" | Commitment (DRC or part-time)
! scope="col" width="150" | Email
|-
| [[Nikolay Georgiev]] || create tasks || [http://microfundingtest.openfarmtech.org/mywebsite.php Embeddable Badge] || project manager and web programmer (intermediate PHP and MySQL skills, but no PHP Framework experience, good CSS and Javascript skills) || [[Dedicated Remote Collaboration]] || nikolay (at) opensourceecology.org
|-
| Jacob Roufa || PayPal integeration|| || Project Manager / Intermediate Developer : Drupal, CiviCRM, XHTML/HTML5, CSS, Javascript (jQuery library mostly), PHP, MySQL || DRC if available, part time if not || jacob.roufa@gmail.com
|-
| Eduardo Riesco || || || PHP, MySQL, PostgreSQL/PostGIS, CSS, Java, Drupal, CiviCRM, Joomla || part-time || eduardo.riesco (at) gmail (dot) com
|-
| Alistair MacDonald || creating Drupal Theme || || UI Design & Interaction: JavaScript, CSS, AJAX, HTML5 Video, Flash, Processing.js, jQuery, Graphic Design || Dedicated Remote Collaboration ||
|-
| Lukasz Jagodzinski || creating Drupal Theme || || PHP and Javascript || part-time ||
|-
| Kelly Schutt || Paypal integration || Blocks: OSE info, social sharing || Graphic design, HTML/CSS, Drupal configuration, intermediate Javascript and PHP || part-time ||
|-
|}

OSE Microfunding Proposal/Implementation

2011-07-24T19:04:19Z

Kelly Schutt: /* Team */

=Terminology=
Here is the common terminology:
* TF = True Fan

=Design=
==Wireframes==
The wireframes of the proposal were implemented in [http://www.lumzy.com/ Lumzy].

=Development=
==PHP CMS==
We chose Drupal.

==Drupal Environments==

* Drupal-test - http://microfundingtest.openfarmtech.org/ - used for development and testing
* Official Drupal - http://civicrm.opensourceecology.org/ - used for real

==Page Flow==

[[Image:Ose-microfunding-proposal-flow.png|600px]]

===True Fans Page===
* Description
** Showing motivational content about OSE, its importance, tangible outcome, etc.
** Allowing subscription.
* Transitions
** Recognition Page
*** ''Requirements'': all data for the user is gathered: Name, Email, Subscription (verified, PayPal for now). This means that the user will be forwarded to PayPal, will subscribe, and then comes back to a page of ours - Recognition Page or a temporary page where he can fill out additional information (City, Country, ...) and after submitting these forwarded to the Recognition Page.
*** ''Effects'': the user is added as a True Fan, an embeddable badge is created for him, email notifications is sent to him containing a link to the recognition page.
*** ''Final State'': the user is logged in his Recognition Page

* Design considerations
** TODO by Alistair

===Recognition Page===
* Description
** If The True Fan is logged. Edit mode is available:
*** He sees his information and edit links for video, photo and text are available for clicking.
*** When he saves some information, he will be offered a link to the Share page.
** If it is not the True Fan who is logged, or it is an anonymous user:
*** The person sees the information the True Fan has saved.
*** Under that is the TF subscription.
*** There is a login link somewhere (top-right?), so that if this is the TF itself, he can login to his page.
* Transitions
** Share Page
*** ''Requirements'':
**** TF of the Recognition page should be logged
**** video or text should be filled out.
**** The TF clicks on the "Share page" link.
*** ''Effects'': no
*** ''Final State'': the TF is logged in the Share page.
* Design Considerations
** Add form inputs for user to link to their Twitter, Facebook accounts for use in sharing page.

===Share Page===
* Description
** If The True Fan is logged. Edit mode is available:
*** The TF writes the name, email of several of his friends, and clicking on each one of the added friends, he can add a personal video and text below. He can add/remove/edit friends and their data.
*** He can send the data either to one of his friends (maybe a button to the right of the email) or to all of them (asking for confirmation).
** If it is not the True Fan who is logged, or it is an anonymous user:
*** the page is not accessible.
* Transitions
** Share Page
*** ''Requirements'':
**** TF cliks on invite friend, or invite all friends.
*** ''Effects'':
**** a notifications appears that the friend/s was/were successfully invited.
**** an email is sent to every invited friend, containing a link to the "Invited Page".
**** a link is offered back to his Recognition Page. In this case he can just open it (this transition understandable and will not be described).
*** ''Final State'': the TF remains on the Share page.

===Invited Page===
* Description
** Everybody who has the link can access it, no difference between logged users and anonymous.
** Shows the invitation of the TF to his friend.
** Shows the TF subscription.
* Transitions
** Recognition Page
*** the same transition as in the True Fans Page

=Strategy=
==Video==
The videos can be
* youtube video (easy to program, time-intensive for the user)
* flash camera recorder (harder to program, quick to record for the user, lower quality)

We have the possibility of providing the user with two options:

# Past a link to a YoueTube video
# Record video from Flash and upload to YouTube using their developer API

If we rely on Option 2, we might bottleneck the development. It would make sense to build the functionality for Option 1 first and then begin working on a solution for Option 2 when the project is functionally complete.

Details of the YouTube's video uploads can be found here:
* http://code.google.com/apis/youtube/2.0/developers_guide_protocol.html#Uploading_Videos
* http://code.google.com/apis/youtube/2.0/developers_guide_protocol.html#Resumable_uploads

=Tasks=

You can view the current tasks in the [https://www.pivotaltracker.com/projects/335285 Pivotal project].

==Badges==
* Check a demo for the embeddable badge: http://microfundingtest.openfarmtech.org/mywebsite.php
** Parameters:
*** id - true fan id
*** name - if equals 1, then displays the name of the True Fan above the badge, otherwise not.
** TODO - make secure reading of the URL parameters
* TODO - make a visualization of all OSE badges.

==PayPal==
* Jacob Roufa is trying to integrate PayPal into the registration process of Drupal 7 users: http://www.deerwalk.com/PayPal-Integration-with-Drupal-7
** TODO - still getting bugs
*** Using the [http://drupal.org/project/lm_paypal lm_paypal] module, a key function of the module (displaying the paypal button allowing users to subscribe to a role) is not working.
*** Block configuration found here : http://microfundingtest.openfarmtech.org/admin/structure/block/manage/block/1/configure (note: lm_paypal is currently disabled on the site)
*** Thread in Drupal.org project page issue queue here : http://drupal.org/node/733520
** Implementation without lm_paypal described in the Drupal Tasks section here : http://opensourceecology.org/wiki/OSE_Microfunding_Proposal/Implementation#Other_Drupal_tasks

==Design==
* Alistair MacDonald and Lukasz Jagodzinski are working on a Drupal theme, in an ose.org style and layout as definded in the wireframes.

==Other Drupal tasks==
* '''Show a text when certain fields are filled out'''
** We will need this for the Recognition page - when the video and text are filled out a text linking to the Share page should be displayed.
* '''True Fan status'''
** requested - a person has requested a True Fan status - An statusadmin should check whether there is a subscription by this
** true fan - the person is a True Fan
*** list of subscriptions - a True Fan can have more than one subscription, e.g. now $10, after few months $20.
*** from - the date of subscription
*** to - the date of unsubscription
*** amount - the amount of the subscription
* '''Configure Invite and User Relationships'''
** Allow users with the True Fan role to invite multiple friends
** Make sure the relationship shows between the invited and the invitee
*** Create a block using Views to show relationships
**** Make sure the block view uses arguments such that users are dynamic
**** Show block on Recognition, Share and Invited pages
* '''Create block to show all True Fans'''
** Show this block universally
** Block should just be list of True Fan users as their pictures
* '''Create block with PayPal button link to donate'''
** Show this block below main content on the True Fans page
** Block will show a standard PayPal button, let the user subscribe through PayPal and redirect him back to a Drupal user registration page. When he registers, he should have the status "True Fan Requested" (or similar) and an Administrator should approve it.

=Team=

This is the Team working currently on the Proposal.

{| border="1"
|+ Microfunding IT Team
|-
! scope="col" | Name
! scope="col" | Current Tasks
! scope="col" | Finished Tasks
! scope="col" width="150" | Skills
! scope="col" width="150" | Commitment (DRC or part-time)
! scope="col" width="150" | Email
|-
| [[Nikolay Georgiev]] || create tasks || [http://microfundingtest.openfarmtech.org/mywebsite.php Embeddable Badge] || project manager and web programmer (intermediate PHP and MySQL skills, but no PHP Framework experience, good CSS and Javascript skills) || [[Dedicated Remote Collaboration]] || nikolay (at) opensourceecology.org
|-
| Jacob Roufa || PayPal integeration|| || Project Manager / Intermediate Developer : Drupal, CiviCRM, XHTML/HTML5, CSS, Javascript (jQuery library mostly), PHP, MySQL || DRC if available, part time if not || jacob.roufa@gmail.com
|-
| Eduardo Riesco || || || PHP, MySQL, PostgreSQL/PostGIS, CSS, Java, Drupal, CiviCRM, Joomla || part-time || eduardo.riesco (at) gmail (dot) com
|-
| Alistair MacDonald || creating Drupal Theme || || UI Design & Interaction: JavaScript, CSS, AJAX, HTML5 Video, Flash, Processing.js, jQuery, Graphic Design || Dedicated Remote Collaboration ||
|-
| Lukasz Jagodzinski || creating Drupal Theme || || PHP and Javascript || part-time ||
|-
| Kelly Schutt || Adding OSE info and social sharing blocks || || Graphic design, HTML/CSS, Drupal configuration, intermediate Javascript and PHP || part-time ||
|-
|}