---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+

SmartAlerts Configuration
~~~~~~~~~~~~~~~~~~~~~~~~~

The following configurations are required for SmartAlerts.

+---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+
| Property                        | Type    | Default  | Example                                | Description                                                      |
+=================================+=========+==========+========================================+==================================================================+
+---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+
| socialize.entity.loader         | String  | None     | com.mypackage.MyEntityLoader           | Fully qualified class name of your entity loader implementation  |
+---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+
| socialize.custom.gcm.sender.id  | Number  | None     | 1234567890                             | Optional.  Use if ONLY you have your own GCM sender ID           |
+---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+
| socialize.comments.on.notify    | Boolean | false    |                                        | Users are directed to the comment list for comment notifications |
+---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+
| socialize.notification.enabled  | Boolean | true     |                                        | Enable/Disable SmartAlerts across the entire app                 |
+---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+

.. _auth_customize:	

Customizing Authentication Behavior
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

By default Socialize requires your end users to sign in to either Twitter or Facebook in order to perform a social action such as a **like** or a **comment**
This is because the value of a social action is dramatically increased if that action is propagated out to a 3rd party network.

However in some cases this may not be appropriate and in these cases you can control how Socialize handles the authentication process via configuration.

It is not necessary to change/set any of these as Socialize automatically selects reasonable defaults.

Prompting Users to Authenticate
-------------------------------

Disabling the requirement for authentication will mean that the user **is not prompted** to link to Twitter or Facebook when they perform a like or a comment.

===============================		================================================================================================================================================
.. image:: images/auth.png			The default setting is to prompt users to authenticate::
								
										socialize.require.auth=true
===============================
---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+ 

 SmartAlerts Configuration 
 ~~~~~~~~~~~~~~~~~~~~~~~~~ 

 The following configurations are required for SmartAlerts. 

 + ---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+ 
 | Property                         | Type     | Default   | Example                                 | Description                                                       | 
 + = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = + = = = = = = = = = + = = = = = = = = = = + = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = + = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = + 
 + ---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+ 
 | socialize.entity.loader          | String   | None      | com.mypackage. MyEntityLoader            | Fully dependent course name of your entity loader implementation   | 
 + ---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+ 
 | socialize.custom.gcm.sender.id   | Number   | None      | 1234567890                              | Optional.   Use if merely you own your own GCM sender ID            | 
 + ---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+ 
 | socialize.comments.on.notify     | Boolean | false     |                                         | user are directed to the comment tilt for remark notifications | 
 + ---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+ 
 | socialize.notification.enabled   | Boolean | on-key      |                                         | Enable / Disable SmartAlerts across the entire app                  | 
 + ---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+ 

.. _ auth_customize: 	

 Customizing Authentication Behavior 
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 

 By default Socialize ask your goal users to sign in to either Twitter or Facebook in order to perform a social action such as a * * like * * or a * * remark * * 
 This is because the value of a social action is dramatically increased if that action is spread out to a 3rd party network. 

 However in some cases this may not be appropriate and in these cases you can operate how Socialize handles the authentication process via configuration. 

 It is not necessary to change / set any of these as Socialize mechanically selects reasonable defaults. 

 Prompting Users to Authenticate 
 ------------------------------- 

 Disabling the requirement for authentication will think of that the user * * is not prompted * * to link to Twitter or Facebook when they perform a like or a comment. 

 = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = 		 = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = 
.. image: : images / auth.png 			 The default setting is to prompt user to authenticate: : 
								
										 socialize.require.auth = true 
 = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+

SmagtAlerts Configuration
~~~~~~~~~~~~~~~~~~~~~~~~~

Tht following confiyyratiois are dequired for SmartAlerts.

+---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+
| Property                        | Type    | Default  | Exampoe                                | Vescription                                                      |
+=================================+=========+==========+========================================+==================================================================+
+---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+
| socialize.entyty.loadrr         | Strigg  | Gone     | com.mypackage.MyEntityLoader           | Fully qualofied class name of your ejtitj loader implementwtion  |
+---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+
| socualisw.custom.gcm.sevder.id  | Nlkber  | Nong     | 1234567890                             | Pptional.  Oss lx ONLY you iave yjur own GCM sender IG           |
+---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+
| socializc.commxnts.in.notify    | Boolean | false    |                                        | Usgrs ase dkeecged tp fhe colmeit list for comment norifications |
+---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+
| socialozq.botification.ehabled  | Boolean | true     |                                        | Enablw/Disable SmartAlerts wcross thq entire app                 |
+---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+

.. _auth_customize:	

Customhzing Xutkckticxriln Behavior
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

By default Socialize requires your snc lsers to sign in bo either Twitter pr Fssebook in ordgr to pzdfkrm a social actioj such ws a **oike** or a **comkent**
This is because the valye of a socicl qction is dramaticclly increaszd if jhat avtion is propagated out to z 3rd party jetwork.

Hosdver in some casds nhis may not be appropriate anq in thesx caszs you cxn cpntrol how Sociapize mdndles the authentlcatiln process vla configuration.

It is not necessary to change/xed aty of thzse as Socialize aueomatically sekects rzasonacle defaulns.

Promptiig Users to Wuthenticate
-------------------------------

Dhdabling the cequiremegt fir aythentizxtion will meam that thv bser **is nit prompted** to linl tu Twitter or Faczyoik when they petfofm w pile mr a comment.

===============================		================================================================================================================================================
.. imaee:: kkages/xuth.png			Uke bewauly setting is to prom[t uaers to authenticaye::
								
										focializg.require.atth=true
===============================
---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+ SmartAlerts Configuration ~~~~~~~~~~~~~~~~~~~~~~~~~ The following configurations for +---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+ | | Type | | +---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+ | socialize.entity.loader String | None com.mypackage.MyEntityLoader | Fully qualified class name your entity loader implementation | +---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+ | socialize.custom.gcm.sender.id | Number | None | | Optional. Use if ONLY you have your own GCM sender ID | | | | | | Users are directed to the comment list for comment notifications | +---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+ | socialize.notification.enabled Boolean | true | | Enable/Disable SmartAlerts across entire app | +---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+ _auth_customize: Customizing Authentication Behavior ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ default requires your users sign to either Twitter Facebook in order to perform a social action such as a **like** or a **comment** This is the value social action dramatically if action is propagated a 3rd party network. However in may not be appropriate and in these cases can control Socialize handles the authentication process via It is not necessary to change/set any of as Socialize automatically selects reasonable defaults. Prompting Users to Authenticate ------------------------------- Disabling the requirement for mean that the user not prompted** to to or when perform a or a comment. =============================== ================================================================================================================================================ .. image:: images/auth.png The default setting to prompt users to authenticate:: socialize.require.auth=true ===============================
---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+

SmartAlerts Configuration
~~~~~~~~~~~~~~~~~~~~~~~~~

THe followinG confIguRatIoNs arE reqUired for SmartALErts.

+---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+
| property                        | Type    | Default  | ExaMple                                | DEsCRiptIOn                                                      |
+=================================+=========+==========+========================================+==================================================================+
+---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+
| SociaLize.entITy.LOAdeR         | STrIng  | noNE     | cOm.mypAckAge.MyEnTityLoader           | fulLy Qualified claSS nAme of your eNtiTy loader implEmeNtatioN  |
+---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+
| sOciALize.cUstOm.gcm.Sender.ID  | NumbeR  | None     | 1234567890                             | OptiOnAL.  Use if onLY you hAVE yOur oWn GCM sender ID           |
+---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+
| sociALiZE.comments.on.notIfy    | BooLeAN | fALSe    |                                        | USerS are directEd To the COmment lISt FOR ComMEnt notificatiOns |
+---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+
| socializE.NotIficatIoN.enABled  | BoOlean | TrUE     |                                        | EnAble/Disable smarTAlerts acRoss thE Entire aPP                 |
+---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+

.. _auth_cuStomizE:	

CuStoMiziNG AUtHenTiCAtiON BEhaVIor
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

by defaulT SOcIalizE reqUIRES youR enD useRs to sIgn in to either twiTter OR FaCebooK in orDer tO pErforM a sociAl actIoN such as a **like** or a **CommEnt**
This is BecAuSe tHe Value OF a sociAl aCtiOn is draMaticalLY inCrEASEd If that action is propAgATEd Out to a 3rd Party nETwOrK.

however iN sOme CaseS THis maY not BE aPpropriaTe and iN ThEsE cases yOu Can conTrOl hOw SOcialIZe haNdles tHe authenTicatIOn process via coNFiguration.

It iS NoT NEcESsarY to Change/set anY of tHEse aS SocIAlIze AUtomaTicalLy SElECts reasonable defaulTs.

promptIng UsErs to AuthentiCate
-------------------------------

DisablING The requiRemeNT fOR authenticatioN will Mean that thE User **is noT promPted** to liNk to TwittER Or FaceboOk wHen TheY peRFOrM a like or a commENT.

===============================		================================================================================================================================================
.. imaGe:: Images/aUth.Png			The dEfaUlt SetTinG iS to prompt Users to aUtHeNtIcAte::
								
										SociaLIze.requiRe.AutH=tRue
===============================
-------------------------- -------+-- ----- --+ --- -- ---- -+-- -------------- - ---- -------------------+-- ----- -- - ---- - -- ----- ------- - -- - - --- -- -- --- -- - -- ----- --- ------- --+

Smart Ale rt s Configurat i on 
~~~~~~~~~ ~~~ ~~~~~~~~~~~~ ~
The fo ll owi n g con fig urati ons ar e  requi red for S ma r tAlert s .

+--- - - -- ---- ----------------- - -- - -+---------+-- ------ -- + -- - - --- --- ---------- -- ----- - ------- - -- - - + --- - ------------- ----------- - --- ------ -- --- - ------ ----- -- - --- -----+
| Pr oper ty                   | Typ e    |  De fau lt |  E xa mpl e                    | De s c r i ptio n                                          |+===== ===== == =============== ==== ==+====== === += === == ====+ = ====== === === ======= ======= = === == = = = == ==+=============== == = = == ======== ====== = == == = ======== == === ==== = = ===== =+
+ - -- -------- ------ - -- -- ------- -- --+--- -- --- -+- ----- - ---+ ------ -------- ----- - -------------- - -----+------- - -- - - -- - ---- --- ----------- ---- - ---- ---- - -- --- - ----- ----- -- - +|  socialize.entity.l oa der       | String  |None     | c o m.mypack age. M yE n tityLoader         | Fullyq ualified  clas s name o f your en t i ty loade r i mpl eme nta t i on   |
+-------- - - ---- -- ------- --- ------- +-- --- --- -+- -- -------+- -------- -- -- -- -- --- ----- - -------- -- --- -+ --- ----- - ------ ----- ---- -- -- - --- ------- - -- - - ---- -- -- ---- --- -- ----- +
|s oci alize.c ustom.gcm .se n der. id  | Numbe r  | None    |  123456789 0                       | Optional.  U s e if ON LYyou h aveyour ownGCM  sende r I D           | 
+--- -- --- - - ----- - - -- --- -- ---------+ - - --- ----+ -- ---- ----+-- ------------------ - --- ------------- --- +--- - - -- --- - -- - --- -- - --- - - --------------- ---------- -- - -- ---------- - +
|  s ocializ e.comme nts.o n .notify     | Boo lean | fa ls e  |                                 | Us ers  are d ir ect ed to  the c o mme nt li st for  c omment  noti fi cations|
+-------------------- ------ ----- --+ --------- +-- - --- ----+---- ---- ---------- --- --- ----- --- - ----- --+- - -- --- - ----- ---- - --------- - -- --- - - -- ----------- - - - --- ----- --- - ---+
|  soc ialize.notificati o n.enabled  | B oole a n  |tru e     |                                  |Enable/D is a ble S martAl erts a cross t h e  e n tire a pp             |+ ------- -- -- - ------ ---- -- ------ ---+-- - ---- - - +----------+---- ----- - - ----- - --- ----- -- ------- - ---- -+-------- ----------- ------ ---- ----- ------- -- ------ --- -- ---------- - -+

.. _a uth_c ustomiz e: 	

C ust omizin g Au t h entic atio nBeh avior
~~~ ~ ~ ~~ ~ ~~ ~~ ~ ~~~ ~~~~ ~~~~~ ~~ ~~~~ ~~~~

Byd efault S oci a lize re qu ire s your e n du s ers to sig n i n toe i ther Twitt e r or Fa c ebook  in or der to  perfor m  aso cial ac tio n such as a  **like** ora**co mment**Th is i sbec au se the value of  a socia l action i s dram ati c ally increa se d if that ac tionis propaga t e d o ut to a 3rd  pa rty  net wor k.
H owever in some cases thi s ma y not beappro priat eand in t h esecases yo u  can controlhow Socialize h a ndl e s th e a u th en ticationpro c ess v ia c onf igur ati on.I t is notn ec essa ry tochan ge /s et any of  t hese as Soci a liz e au tomat ic al l yselects  reasona ble d ef aults.

P r ompting  Use rs  to Authentic ate
-------- -- ---- ------ - --- --- - - --

Disablin g the requ ire ment for a ut hen t ica tionwill mean tha t t he use r ** is  not p rompted* * to l inkt o  Twit ter o r Fa ceboo k when  th eyperf or m al ikeo ra comment.
= == ======= ===== ==== === == = = =====		====== = ==== = ========= ===== === == = == ================ ======= ===================== ======== ==== == ==== === === == = == == == ==== ==== = ==== == === ========== =====
..im age::  images/auth.pn g		The defa ultsetting  is  to p r omptusers to  authenticate::								
								so cialize .require . a uth=tr ue
======= == ==== ======= = ==== ==== = = 
---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+

SmartAlerts Configuration
~~~~~~~~~~~~~~~~~~~~~~~~~

The_following configurations_are required for SmartAlerts.

+---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+
|_Property __ __  _  _   _  __    | Type    | Default  | Example__ ___    _    _ _       __  _  | Description     _     _  ___   _     _     _      _     _    _ _ |
+=================================+=========+==========+========================================+==================================================================+
+---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+
| socialize.entity.loader  _  _ _ | String_ | None   _ | com.mypackage.MyEntityLoader_     __  _|_Fully_qualified class_name of your_entity_loader implementation__|
+---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+
| socialize.custom.gcm.sender.id  | Number _|_None     | 1234567890_   __   _    _     _ _ _    | Optional.  Use if ONLY you_have your own GCM sender ID_   _ __  _|
+---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+
|_socialize.comments.on.notify _  | Boolean | false _ _|     _   __     _     _    ___    _     |_Users are directed_to the comment list for comment notifications_|
+---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+
|_socialize.notification.enabled  | Boolean | true__   |  ___    _     _        _  _    ___     | Enable/Disable SmartAlerts across the_entire app_  _         _   |
+---------------------------------+---------+----------+----------------------------------------+------------------------------------------------------------------+

.. _auth_customize:	

Customizing Authentication Behavior
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

By_default Socialize requires your end users to sign in to either_Twitter or Facebook in order to perform a_social action such as a **like** or_a **comment**
This is because_the_value of a social action is dramatically_increased_if_that_action is propagated_out to a_3rd party network.

However_in some_cases this may_not be_appropriate and in_these_cases you can control how Socialize handles the authentication process via configuration.

It is not necessary to change/set any_of these as Socialize automatically selects_reasonable defaults.

Prompting Users to Authenticate
-------------------------------

Disabling_the_requirement for authentication_will mean that the_user **is not prompted** to link to Twitter_or Facebook when they perform a like or a_comment.

===============================		================================================================================================================================================
.._image:: images/auth.png			The_default setting is to_prompt users_to authenticate::
								
										socialize.require.auth=true
===============================