DEPRECATION WARNING
This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.
EXT: Ajado Facebook¶
| Author: | Christopher |
|---|---|
| Created: | 2010-12-18T19:57:23 |
| Changed by: | Matteo Savio |
| Changed: | 2011-12-30T23:46:42 |
| Classification: | ajado_facebook |
| Description: | The keywords help with categorizing and tagging of the manuals. You can combine two or more keywords and add additional keywords yourself. Please use at least one keyword from both lists. If your manual is NOT in english, see next tab "language" ---- forEditors (use this for editors / german "Redakteure") forAdmins (use this for Administrators) forDevelopers (use this for Developers) forBeginners (manuals covering TYPO3 basics) forIntermediates (manuals going into more depth) forAdvanced (covering the most advanced TYPO3 topics) see more: http://wiki.typo3.org/doc_template#tags ---- |
| Keywords: | forAdmins, forIntermediates |
| Author: | Christopher |
| Email: | Chrissitopher@gmx.de |
| Language: | en |
EXT: Ajado Facebook¶
Extension Key: ajado_facebook
Language: en
Version: 0.1.0
Keywords: forAdmins, forIntermediates
Copyright 2006-2011, ajado , <info@ajado.com>
This document is published under the Open Content License
available from http://www.opencontent.org/opl.shtml
The content of this document is related to TYPO3
- a GNU/GPL CMS/Framework available from www.typo3.org
Table of Contents¶
`EXT: Name of your Extension 1 <#__RefHeading__5708_1738894311>`_
`Introduction 3 <#__RefHeading__5710_1738894311>`_
`Users manual 4 <#__RefHeading__467_413120346>`_
`Administration 5 <#__RefHeading__31511_818911409>`_
`Configuration 6 <#__RefHeading__31515_818911409>`_
`Tutorial 8 <#__RefHeading__31523_818911409>`_
`Known problems 9 <#__RefHeading__31525_818911409>`_
`To-Do list 10 <#__RefHeading__477_413120346>`_
`ChangeLog 11 <#__RefHeading__31623_818911409>`_
`Important guidelines 12 <#__RefHeading__31625_818911409>`_
HowTo: Update a manual to the new layout 13
HowTo: Alternative updating possibility: Import the styles from another document 14
HowTo: Fix the Table Of Contents when it is empty 14
HowTo: Fix the Table Of Contents when a chapter is missing 15
Introduction¶
What does it do?¶
This extension provides a Facebook Connect-Module for TYPO3, that focuses on comaptibility with sr_feuser_register (so that both a registration via e-mail and Facebook can be users), OAuth2 and takes care of all the Facebook-changes after 1 st of October 2011.
A general introduction and the reasons why we developed the extension can be found here: http://www.ajado.com/blog/presentation-facebook- connect/
If you're interested in the development, you can participate here: https://github.com/ajado/ajado_facebook
Facebook-login with customized button in the Frontend:
Users manual¶
In order to use this extension you need to create an App on Facebook. You'll find detailled information in this tutorial:
http://developers.facebook.com/docs/appsonfacebook/tutorial/
Be aware that you need to integrate the app on Facebook just as “Website”, not as “App on Facebook”.
The information you need in the extension configuration is the “App ID” and the “App Secret”
FAQ¶
Coming soon...
Administration¶
The user records can be found in the fe_user. Be aware that because of the requirement to work with sr_feuser_register the mail we get from Facebook is not stored in the fe_user e-mail field but in the tx_ajadofacebook_email column.
FAQ¶
Coming soon...
Configuration¶
The configuration can mostly be done via the Constants editor, the list here shows all parameters that can be set in Setup.
Reference¶
appId¶
Property
appId
Data type
string
Description
Facebook app id:The app id of your Facebook application
Default
secret¶
Property
secret
Data type
wrap
Description
Facebook secret:The application secret of your Facebook application
Default
usersPid¶
Property
usersPid
Data type
Int
Description
User storage page:uid of the page where Frontend user records are stored
Default
userGroup¶
Property
userGroup
Data type
Int
Description
Redirect after login page:uid of the page where the user will get redirected after login
Default
askForEmail¶
Property
askForEmail
Data type
boolean
Description
Save Facebook-Email in fe_users
Default
0
redirectAfterLoginPid¶
Property
redirectAfterLoginPid
Data type
Int
Description
Redirect to Pid after succesfull Login. If 0 the current page will be used.
Default
0
redirectAfterLogoutPid¶
Property
redirectAfterLogoutPid
Data type
Int
Description
Redirect to Pid after successful Logout. If 0 the current page will be used.
Default
0
facebookLanguage¶
Property
facebookLanguage
Data type
string
Description
Set facebook language
Default
en_EN
makeSessionPermament¶
Property
makeSessionPermament
Data type
boolean
Description
Make fe_user-session permament.
Default
loginButton¶
Property
loginButton
Data type
HTML
Description
Change login button
Default
logoutButton¶
Property
logoutButton
Data type
HTML
Description
Change logout button
Default
copyFacebookImageToImageDir¶
Property
copyFacebookImageToImageDir
Data type
boolean
Description
Set to 1 if you want the extension to save the Facebook profile image locally
Default
0
imageDir¶
Property
imageDir
Data type
string
Description
Specifies directory where profile image should be set. Attention: the default value requires the extension sr_feuser_register!
Default
uploads/tx_srfeuserregister/
Example¶
Coming soon...
Tutorial¶
Coming soon...
Known problems¶
None at the moment.
To-Do list¶
- Change loginButton and logoutButton into a IMAGE-Object
- Expand documentation
- Think about rewriting it in extBase?
ChangeLog¶
0.3.0¶
Version
0.3.0
Changes
Major upgrade:
* Bugfix when running the extension without sr_feuser_register
* Added possiblity to locally save the Facebook profile image - installed sr_feuser_register recommended
* Added possibility to stay on same site when logging in
* Cleaned up files and code
0.2.2¶
Version
0.2.2
Changes
Security fix
0.2.1¶
Version
0.2.1
Changes
Manual extended
0.2.0¶
Version
0.2.0
Changes
Manual extended, Constants and setup cleaned up
0.1.0¶
Version
0.1.0
Changes
Initial upload
Important guidelines¶
Coming soon...