librelist archives

« back to archive

Friendica documentation and support

Friendica documentation and support

From:
Richard Powell
Date:
2014-11-30 @ 17:42
Hello again,

There are so many things I want to say, and so many discussions I'd like 
to have about my experience installing and configuring Friendica, that I 
don't feel I can do so in a single email.  And also, it is not clear 
whether this is the appropriate forum for these discussions in the first 
place.  It just say's "Mailing List" on the Friendica.com website.  What 
does that mean exactly (discussion list, or notification/alert list, or 
something else)? So, let me start with this one topic.

Is this email list, the only place where folks can discuss the 
installing and configuring of Friendica on their website or server? Or, 
is there a place, such as a web forum where we can discuss different 
aspects of this project and software?  Because I'm certain there are 
different types of people who only want to have a discussion about one 
aspect, be it programming, administration, or user interface.   There's 
just seems too much to discuss to encompass a single email list.  And 
don't get me started on how user-un-friendly this email list is.  :-)

I have found several areas during the setup process where the 
documentation (while decent), is fragmented and missing fairly important 
information.  I had to go to google at least a half dozen times to get 
questions answered.  As an example, installing the "Facebook Connector" 
addon was something that only a person familiar with github and 
development/programming could have figured out. When you look at the 
facebook connector addon, the text next to is says "Mark facebook and 
faceboo_restrict as unsupported, change version num...", which, from an 
admin or user perspective is confusing to say the least.  It was only my 
guess that this was a most recent comment from a developer that allowed 
me to see past this text and grab the code and put into the "addon" 
sub-folder. Which also, by the way, was a difficult instruction to 
locate.  I had to search google once again to find out that creating 
this sub-folder was how you install the addons.  Also, I was unable to 
just download the facebook connector.  I had to download ALL the addons 
as a zip file.  But it was only my intuition as a hobby developer that 
allowed me to find the place to download all the addons.

And then there's  process of getting the app approved to post to 
Facebook.  Nowhere in the instructions does it mention you'll need to 
"submit for approval" your app, which is not really your app at all, to 
Facebook for approval.  Perhaps this is a new process over at Facebook, 
I don't know.  But it is a hurdle I have not yet figured out how to get 
past.  All I wanted to do was *test* the damned thing.  But Facebook is 
acting like it's a production ready app that I'm going to share with the 
world, and I have to jump through all these hoops to integrate the 
thing.  It would be helpful if Friendica had a list of answers to the 
questions that Facebook asks to approve the app.  FB even alerts me that 
they see no record of me having tested my new app (again, which is not 
my app, it is a version/instance of Friendica's app).  If every 
installation of a Friendica hub has to answer these same questions, can 
we put together a list of what the answers are so that every single 
person doesn't have to invent their own answers?

There's just no way the average person is going to jump through these 
hoops to get their Friendica hub connected.

Anyway.  Sorry.  I know that I'm rambling.  It's just that I can see 
such great potential in this software, and I would love to help nurture 
it if I can.  At the moment, I'm not entirely sure where I can best be 
of value to the project.

Thanks
Richard Powell
Host Pond Web Hosting
http://hostpond.com/

Re: [friendica] Friendica documentation and support

From:
Michael Vogel
Date:
2014-12-01 @ 13:08
> You don't have to submit your app for approval to Facebook.

The approval for Facebook apps is new. I guess they want to reduce the 
number of applications.

Re: [friendica] Friendica documentation and support

From:
Benjamin Liyanage
Date:
2014-12-01 @ 17:24
Yes, they have made a number of changes to their api, including a number of
new permission hooks. A number of the new hooks need explicit approval by
their approval process.

I highly recommend you try to do a fresh install with a new facebook app to
be run the full gamut. Currently only new people signing up for these apps
are hitting these issues, but when they release the next versionif their
api (no clue when, I think it's not announced at this point) older api keys
will cease to works, as well as the fql interface.

-Ben

On Monday, December 1, 2014, Michael Vogel <annando@ymail.com> wrote:

> You don't have to submit your app for approval to Facebook.
>
>
> The approval for Facebook apps is new. I guess they want to reduce the
> number of applications.
>

Re: [friendica] Friendica documentation and support

From:
Keith Fernie
Date:
2014-12-01 @ 18:58
Details of the api availability are here
https://developers.facebook.com/docs/apps/changelog?locale=en_GB

After April 30, 2015 api 1.0 calls should be treated as api 2.0 calls
with fql available.
After August 7, 2016 api 1.0 & 2.0 should be treated as api 2.1 calls
with fql becoming unavailable;

To run the latest api, the api calls could be versioned, except for
those using fql, using your existing apps.  

Keith

On Mon, 2014-12-01 at 09:24 -0800, Benjamin Liyanage wrote:
> Yes, they have made a number of changes to their api, including a
> number of new permission hooks. A number of the new hooks need
> explicit approval by their approval process. 
> 
> 
> I highly recommend you try to do a fresh install with a new facebook
> app to be run the full gamut. Currently only new people signing up for
> these apps are hitting these issues, but when they release the next
> versionif their api (no clue when, I think it's not announced at this
> point) older api keys will cease to works, as well as the fql
> interface. 
> 
> 
> -Ben 
> 
> On Monday, December 1, 2014, Michael Vogel <annando@ymail.com> wrote:
>         > You don't have to subm it your app for approval to Facebook.
>         
>         The approval for Facebook apps is new. I guess they want to
>         reduce the number of applications.

Re: [friendica] Friendica documentation and support

From:
Benjamin Liyanage
Date:
2014-12-01 @ 19:39
As a slight clarity--people who create new apps are forced onto the newest
version of the API, with no ability to to use the older (aka 1.0 or 2.0
where FQL is available) versions of the API.

-Ben

On Mon, Dec 1, 2014 at 10:58 AM, Keith Fernie <me@friendica.eu> wrote:

> Details of the api availability are here
> https://developers.facebook.com/docs/apps/changelog?locale=en_GB
>
> After April 30, 2015 api 1.0 calls should be treated as api 2.0 calls
> with fql available.
> After August 7, 2016 api 1.0 & 2.0 should be treated as api 2.1 calls
> with fql becoming unavailable;
>
> To run the latest api, the api calls could be versioned, except for
> those using fql, using your existing apps.
>
> Keith
>
> On Mon, 2014-12-01 at 09:24 -0800, Benjamin Liyanage wrote:
> > Yes, they have made a number of changes to their api, including a
> > number of new permission hooks. A number of the new hooks need
> > explicit approval by their approval process.
> >
> >
> > I highly recommend you try to do a fresh install with a new facebook
> > app to be run the full gamut. Currently only new people signing up for
> > these apps are hitting these issues, but when they release the next
> > versionif their api (no clue when, I think it's not announced at this
> > point) older api keys will cease to works, as well as the fql
> > interface.
> >
> >
> > -Ben
> >
> > On Monday, December 1, 2014, Michael Vogel <annando@ymail.com> wrote:
> >         > You don't have to subm it your app for approval to Facebook.
> >
> >         The approval for Facebook apps is new. I guess they want to
> >         reduce the number of applications.
>
>
>

Re: [friendica] Friendica documentation and support

From:
Michael Vogel
Date:
2014-11-30 @ 18:27
Hi!

The "facebook" addon is unsupported. It was replaced by the combination of 
"fbpost" and "fbsync". The problem with "fbsync" is that Facebook changed 
the API so that at the moment you can't register a new app that would work 
with fbsync. It is on the list to make fbsync compatible with the changes 
- but this means a complete rewrite of this addon.

Concerning the addons it's the best to download and extract them all. You 
can then enable only the ones you want at a later time.

Re: [friendica] Friendica documentation and support

From:
Keith Fernie
Date:
2014-12-01 @ 12:53
You don't have to submit your app for approval to Facebook.
I've been running Facebook apps for Friendica for years on public
servers, none of my apps have been submitted to Facebook for approval.

Re: [friendica] Friendica documentation and support

From:
Benjamin Liyanage
Date:
2014-11-30 @ 22:43
Yea, the facebook api has been changed.  I've been working on rewriting
some of the sync code, though it is quite a bit of stuff, and has been a
bit difficult since I don't know what it's supposed to look like when it's
working since I am a relatively new user as well.  I have the post sync
working as last I recall--some of the formatting is a little off at this
point though.  I still need to sync comments and likes--I suspect the
latter might be easier with the new API as you can request all that
information at the same time.  I'm hoping to have some time in December to
finish up the work I've done so far.

-Ben

On Sun, Nov 30, 2014 at 10:27 AM, Michael Vogel <annando@ymail.com> wrote:

> Hi!
>
> The "facebook" addon is unsupported. It was replaced by the combination of
> "fbpost" and "fbsync". The problem with "fbsync" is that Facebook changed
> the API so that at the moment you can't register a new app that would work
> with fbsync. It is on the list to make fbsync compatible with the changes -
> but this means a complete rewrite of this addon.
>
> Concerning the addons it's the best to download and extract them all. You
> can then enable only the ones you want at a later time.
>

Re: [friendica] Friendica documentation and support

From:
Benjamin Liyanage
Date:
2014-11-30 @ 22:44
Also, I totally agree about the difficulty of the install.  I think
"signing up" as a new user is also quite difficult, though I have been
working on getting the fb stuff working for myself first.

-Ben

On Sun, Nov 30, 2014 at 2:43 PM, Benjamin Liyanage <
ben@perfectresolution.com> wrote:

> Yea, the facebook api has been changed.  I've been working on rewriting
> some of the sync code, though it is quite a bit of stuff, and has been a
> bit difficult since I don't know what it's supposed to look like when it's
> working since I am a relatively new user as well.  I have the post sync
> working as last I recall--some of the formatting is a little off at this
> point though.  I still need to sync comments and likes--I suspect the
> latter might be easier with the new API as you can request all that
> information at the same time.  I'm hoping to have some time in December to
> finish up the work I've done so far.
>
> -Ben
>
> On Sun, Nov 30, 2014 at 10:27 AM, Michael Vogel <annando@ymail.com> wrote:
>
>> Hi!
>>
>> The "facebook" addon is unsupported. It was replaced by the combination
>> of "fbpost" and "fbsync". The problem with "fbsync" is that Facebook
>> changed the API so that at the moment you can't register a new app that
>> would work with fbsync. It is on the list to make fbsync compatible with
>> the changes - but this means a complete rewrite of this addon.
>>
>> Concerning the addons it's the best to download and extract them all. You
>> can then enable only the ones you want at a later time.
>>
>
>