Difference between revisions of "Profiles Overview"

From ADF Docs
Jump to: navigation, search
(Installation/Setup)
(Installation Guides)
(37 intermediate revisions by 3 users not shown)
Line 1: Line 1:
==Documentation ERRORS==
 
* If you change the Role in the ptProfile.xml file - you need to change the setRolePermission() function in profileRoles.cfc to have the correct permissions for the new role
 
* The profile links (in the top right of the Profile Page) don't work because <DASHBOARD_URL> is not defined in the config struct
 
 
 
== About Profile App ==
 
== About Profile App ==
 
The Profile application is built in the [[Overview|Application Development Framework (ADF)]].
 
The Profile application is built in the [[Overview|Application Development Framework (ADF)]].
  
 
== Overview ==
 
== Overview ==
The profile application provides the functionality to allow users to manage and share their information throughout the site.  A profile page provides the user with a unique page URL that can be shared.  The users can manage their profile pages and edit their information directly through at the page.  Users profile information can be connected and synchronized to an external data source.  Profiles can be configured to allow multiple roles and profile pages in multiple subsites.
+
The profile application provides the functionality to allow users to manage and share their information throughout the site.  A profile page provides the user with a unique page URL that can be shared.  The users can manage their profile pages and edit their information through a profile dashboard page.  Users profile information can be connected and synchronized to an external data source.  Profiles can be configured to allow multiple roles and profile pages in multiple subsites and derived from multiple templates.
  
 
== Requirements ==
 
== Requirements ==
ADF Library components that are required for the Profile:
+
The ADF must be configured correctly for your site. The [[Site Configuration (ADF.cfc)]] wiki page has instructions for configuration.
* ccapi
 
* ceData_1_0
 
* csData_1_0
 
* cssecurity_1_0
 
* data_1_0
 
* forms_1_0
 
* scripts_1_0
 
* utils_1_0
 
 
 
 
 
The ADF must be configured correctly for your site. The [[Site Configuration|Site Configuration]] wiki page has instructions for configuration.
 
  
 
== Contents ==
 
== Contents ==
Line 37: Line 22:
 
This installation guide assumes that you have no Custom Elements/Metadata Forms with the names above.  Before the install, remove any Custom Elements/Metadata Forms with the names listed in the "Contents" section above.  (If you do not remove existing elements with these names, you may have difficulties during the installation.)
 
This installation guide assumes that you have no Custom Elements/Metadata Forms with the names above.  Before the install, remove any Custom Elements/Metadata Forms with the names listed in the "Contents" section above.  (If you do not remove existing elements with these names, you may have difficulties during the installation.)
  
== Installation/Setup ==
+
<!--
Each of the following steps should be completed fully and in the order presented:
+
== CommonSpot Requirements ==
 +
 
 +
If running on '''CommonSpot 6.2.0''', install the following patches:
 +
* [http://www.paperthin.com/support/knowledgebase/articles/ccapi-metadata.cfm 6.2.0.13]
 +
* [http://www.paperthin.com/support/knowledgebase/articles/ccapi-page-audience.cfm 6.2.0.46]
 +
 
 +
If running on '''CommonSpot 6.1''', install the following patches:
 +
* [http://www.paperthin.com/support/knowledgebase/articles/api-textblock-and-subsite-creation-issues.cfm 6.1.0.49b]
 +
* [http://www.paperthin.com/support/knowledgebase/articles/ccapi-default-filetype.cfm 6.1.0.61]
 +
-->
 +
 
 +
== Installation Guides ==
 +
 
 +
'''Current Release Version:'''
 +
* v3.4:
 +
** [[PT_Profile_v3.4_Release_Notes|Version 3.4 Release Notes]]
 +
** [[PT_Profile_v3.4_Install|Version 3.4 Install Guide]]
 +
** [[PT_Profile_v3.4_Upgrade|Version 3.4 Upgrade Guide]]
 +
'''IMPORTANT''': The above versions of this application require '''ADF 2.5''' or greater and '''CommonSpot 10.5.2 or 10.6.1''' or greater.
 +
 
 +
 
 +
'''Previous Versions:'''
 +
* v3.3:
 +
** [[PT_Profile_v3.3_Release_Notes|Version 3.3 Release Notes]]
 +
** [[PT_Profile_v3.3_Install|Version 3.3 Install Guide]]
 +
** [[PT_Profile_v3.3_Upgrade|Version 3.3 Upgrade Guide]]
 +
 
 +
* v3.2:
 +
** [[PT_Profile_v3.2_Release_Notes|Version 3.2 Release Notes]]
 +
** [[PT_Profile_v3.2_Install|Version 3.2 Install Guide]]
 +
** [[PT_Profile_v3.2_Upgrade|Version 3.2 Upgrade Guide]]
  
# [[PT Profile ADF Configuration|PT Profile ADF Configuration]]
+
* v3.1:
# [[PT_Profile_Extract|Extract Profile Application]]
+
** [[PT_Profile_v3.1_Release_Notes|Version 3.1 Release Notes]]
# [[PT Profile Styles|Styles]]
+
** [[PT_Profile_v3.1_Install|Version 3.1 Install Guide]]
# [[PT Profile Import|Import Elements]]
+
** [[PT_Profile_v3.1_Upgrade|Version 3.1 Upgrade Guide]]
# [[PT Profile Site Configuration|Site Configuration]]
+
 
# [[PT_Profile_Build_Templates_Pages|Build Templates/Pages]]
+
* v3.0:
 +
** [[PT_Profile_Release_Notes_v3|Release Notes]]
 +
** [[PT_Profile_Install_v3|Install Guide]]
 +
** [[PT_Profile_Upgrade_v3|Upgrade Guide]]
 +
 
 +
* v2.1:
 +
** [[PT_Profile_Version_2.1_Release_Notes|Release Notes]]
 +
** [[PT_Profile_Version_2.1_Install|Install Guide]]
 +
** [[PT_Profile_Version_2.1_Upgrade|Upgrade Guide]]
 +
 
 +
* v2.0:
 +
** [[PT_Profile_Version_2.0_Install|Version 2.0 Install Guide]]
 +
** [[PT_Profile_Version_2.0_Upgrade|Version 2.0 Upgrade Guide]]
 +
 
 +
* v1.0
 +
** [[PT_Profile_Version_1.0_Install|Install Guide]]
 +
 
 +
<!--
 +
Current Development Builds v3.1:
 +
* [[PT_Profile_Release_Notes_v3.1|Release Notes]]
 +
* [[PT_Profile_Install_v3.1|Install Guide]]
 +
* [[PT_Profile_Upgrade_v3.1|Upgrade Guide]]
 +
-->
 +
 
 +
== Getting Started ==
 +
The installation has been completed and you are ready to start creating profiles.
 +
 
 +
# Navigate to the Profile Dashboard page and click the "Click Here, to create a profile" link.
 +
# In the profile form userid field, enter the CommonSpot username that you logged into the site.  Completed the rest of the form with your bio information.  Submit the form once complete.
 +
# This will create your profile and after the Profile Dashboard page refreshes you'll see your profile info with link to edit and a link to view your profile page.
  
 
== Features ==
 
== Features ==
 
The profile application provides the following features:
 
The profile application provides the following features:
  
* [[PT_Profile_Lightbox|Lightbox]]
+
* [[PT_Profile_Roles|Profile Roles]]
* [[Profile Roles|Profile Roles]]
+
* [[PT_Profile_Multiple_Subsites|Multiple Subsites]]
* [[Multiple Profile Pages|Multiple Profile Pages]]
+
* [[PT_Profile_Multiple_Templates|Multiple Templates]]
* [[Multiple Profile Page Templates|Multiple Page Templates]]
+
* [[PT Profile Gallery|Gallery]]
* [[Profile Select|Profile Select]]
+
* [[PT_Profile_Extended_Elements|Extended Profile Elements]]
* [[Extended Profile Elements|Extended Profile Elements]]
+
* [[PT_Profile_Authorized_Admins|Authorized Administrators]]
* [[Authorized Profile Administrators|Authorized Administrators]]
 
 
* [[PT_Profile_Auto Create|Auto Create]]
 
* [[PT_Profile_Auto Create|Auto Create]]
 
* [[PT_Profile_Bulk Creation/Update|Bulk Creation/Update]]
 
* [[PT_Profile_Bulk Creation/Update|Bulk Creation/Update]]
 
* [[PT_Profile_Hooks to Photo Gallery App|Hooks to Photo Gallery App]]
 
* [[PT_Profile_Hooks to Photo Gallery App|Hooks to Photo Gallery App]]
 
+
* [[PT_Profile_Schedule_Bulk_Update|Nightly Scheduled Job Import/Update]]
== Guides ==
 
* [[How_to_add_profile_role|How to add a new profile role]]
 
  
 
== Known Issues/Bugs ==
 
== Known Issues/Bugs ==

Revision as of 19:34, 3 March 2020

About Profile App

The Profile application is built in the Application Development Framework (ADF).

Overview

The profile application provides the functionality to allow users to manage and share their information throughout the site. A profile page provides the user with a unique page URL that can be shared. The users can manage their profile pages and edit their information through a profile dashboard page. Users profile information can be connected and synchronized to an external data source. Profiles can be configured to allow multiple roles and profile pages in multiple subsites and derived from multiple templates.

Requirements

The ADF must be configured correctly for your site. The Site Configuration (ADF.cfc) wiki page has instructions for configuration.

Contents

The Profile application contains the following:

  • Custom Coding - various components and scripts.
  • CommonSpot Components:

'Note:' Elements may contain one or more: Render Handlers or Custom Field Types. They do NOT use Display Templates.

Pre-installation Considerations

Application Development Framework (ADF) must be setup and configured on the server for the site that will be implementing the Profile application. For detailed instructions, see the Application Development Framework (ADF) wiki page for Site Configurations.

This installation guide assumes that you have no Custom Elements/Metadata Forms with the names above. Before the install, remove any Custom Elements/Metadata Forms with the names listed in the "Contents" section above. (If you do not remove existing elements with these names, you may have difficulties during the installation.)


Installation Guides

Current Release Version:

IMPORTANT: The above versions of this application require ADF 2.5 or greater and CommonSpot 10.5.2 or 10.6.1 or greater.


Previous Versions:


Getting Started

The installation has been completed and you are ready to start creating profiles.

  1. Navigate to the Profile Dashboard page and click the "Click Here, to create a profile" link.
  2. In the profile form userid field, enter the CommonSpot username that you logged into the site. Completed the rest of the form with your bio information. Submit the form once complete.
  3. This will create your profile and after the Profile Dashboard page refreshes you'll see your profile info with link to edit and a link to view your profile page.

Features

The profile application provides the following features:

Known Issues/Bugs

Found a bug, view the Known Issues/Bugs wiki page. Your issue not on the list? Then post it so the issue can be addressed.