( Installation code : kurtjensen.profile )

Installation

• Install other required plugins
  • User plugin by RainLab
  • Location plugin by RainLab
  • UserPlus plugin by RainLab
  • Passage Permission Keys plugin by Kurt Jensen
• Download plugin to plugin directory as you would any other plugin.
• Logout and back into october backend.
• Go to Settings - limit view by entering the search term "profile"
  • You may use "Manage Profile Tabs" to add sections ( Categories ) to user profiles. ( The default tabs are Personal, and Professional )
  • You may use "Manage Profile Labels" to add fields to the sections from above.
    • Set the labels, descriptions and field types for your labels
  • You may use "Manage Profile Panels" to edit the panels registered by october plaugins. You may enable or disable panels here also so they are not available in the Profile Panel Component.
• Goto Users - All Users and start editing each users information or setup a front end page where users can edit their own using the "Profile Panel Component".

Adding a front end page with user profile forms

The "Profile Panel Component" provides a tabbed interface that can be used by front end users to edit their own profile information.

Here is a sample page setup:

• Create a new page titled "Account"

• Set URL to "/account/:code?"

• Add components "Account", "Profile Panel", and "Session" by draging and dropping the "Account" and "Profile Panel" components in the markup area. "Session" component can be double clicked as it does not need to be in the markup area.

• Check the boxes in the "Included Panels" property of "Profile Panel" that you want to show in your page.

• Add page markup:

  {% if user %}
  {% component 'ProPanel' %}
  {% else %}
  {% component 'Account' %}
  {% endif %}

• Save your new page and test it out.

See also: Guide for user to upload image from frontend https://vimeo.com/122505195

Adding a front end page with delegated user-administrator profile forms

WARNING: This page needs to be protected from average user access.

The "User Administrator Panel Component" provides a tabbed interface that can be used by front end users to edit other profiles of users in their own primary user-group.

Before you start Use instructions from Passage Permission Keys plugin to protect this page.

• You will want to create a new key and user-group for profile admins and only allow people you delegated as user administrators to access the component on this page.

The page will contain the forms for your delegated user admins can use to edit profiles of users in their primary group.

Here is a sample page setup:

• Create a new page titled "Profile Administration"

• Set URL to "/profile-administration/:slug?"

• Add component "User Administrator Panel" by draging and dropping the component in the markup area.

• Check the boxes in the "Included Panels" property of "User Administrator Panel" that you want to show in your page.

• Add page markup:

  {% if can('ProfileAdmin') %}
  {% component 'AdminPanel' %}
  {% else %}
  <p class="bg-danger">This page restricted to profile administrators only!</p>
  {% endif %}

• Save your new page and test it out.

Displaying Extended Info and Extended Info Form

The Extended Info component is depreciated and may be removed in future updates.

Creating User Directory Page

The User List component displays a directory of users where you can view all user information. You can add the component to your page and render it with the component tag:

{% component 'UserList' %}

Component Settings you will want check or set:

• Selected User Slug - ( Optional ) Slug for displaying a single users information. If used, page will only display user with an id that matches the slug.

• Show Country Field - Do you want country fields to show in directory?

• Default Sort Order - How users are sorted when page opens.

• Vcard Page - Page where the V-card (Add To Contacts) download page is located (See VCard Component below.

Creating a VCard Download Page

The VCard Component component allows your logged in users to download user information to their electronic address books. You can add the component to a blank page and render it with the component tag:

{% component 'VCard' %}

You will not want any Layout for this page because it is only for downloading vcards and should not display anything else to user.

Component Settings you will want check or set:

• Selected User Slug - Slug for selecting users information to download.

• Permission For Access - The permission required to download a vcard (see Frontend Roles Manager plugin by TreeFiction).
  WARNING - If you choose "none required" then anyone can download v-cards even if they are not logged in.

Creating User Photo Gallery

The Gallery component displays a all the user avatars that have been uploaded by your users. You can add the component to your page and render it with the component tag:

{% component 'Gallery' %}

Component Settings you will want check or set:

• Pictures Per Page - How many photos do you want to show on a page.

Events

This plugin will fire some global events that can be useful for interacting with other plugins.

• kurtjensen.profile.beforeSave: Before the user's changes are saved. Passes the variables posted from the form.
• kurtjensen.profile.afterSave: After the user's changes are saved. Passes the variables saved from the form and the original user model from before the changes.

Here is an example of hooking an event:

Event::listen('kurtjensen.profile.afterSave', function($new_data, $old_user) {
    // Check to see if user changed their email address
      if(!$new_data['email'] == $old_user->email){
                   // Do something if user changed email address
       }
});

Did you find this plugin useful?

Please take some time to provide feeback regarding this plugin. These plugins take many hours to develope and your feedback can be provide significant motivation for coders to make improvements and additional plugins. Please visit http://octobercms.com/plugin/kurtjensen-profile#reviews and provide your review.

If you need help or are having trouble with my plugins then contact me and I will do my best to resolve your issue and consider your suggestions. Please give me a chance to make it right before posting a negative review.

Thank you for your patronage.

Sincerely

Kurt Jensen <kjensen@iaff106.com>

Washington State / USA