Integrate with Almashines

AlphaLearn supports seamless integration with AlmaShines, an external alumni community platform. Once this integration is enabled, a dedicated menu item is added to the trainee’s left-hand navigation panel within the LMS.

By clicking this option, trainees are automatically logged into the AlmaShines portal via Single Sign-On (SSO), eliminating the need for separate login credentials. This provides a smooth transition from the LMS to the alumni community, allowing users to access networking opportunities, events, and alumni resources without interruption.

Generate AlmaShines Credentials

  1. 1

    Log in to your AlmaShines Admin Portal with your admin account.

  2. 2

    Go to Portal Settings from your profile or the Settings menu.

  3. 3

    Open the API Key Generation section.

  4. 4

    Click Generate a new Key and copy both the API Key and API Secret. The secret may not be shown again.

Set Up the Integration in LMS

  1. 1

    Log in to LMS as Admin.

  2. 2

    Navigate to Settings → Integrations.

  3. 3

    Find the AlmaShines card and open it.

  4. 4

    Enter your Sidebar Menu Label, API Key, and API Secret.

  5. 5

    Choose the Require Course Completion setting based on who should see the menu item.

  6. 6

    Click Submit. The integration becomes active, and eligible trainees will see the new menu item after their next page load.

Verify the Trainee Experience

  1. 1

    Log in as a trainee user.

  2. 2

    Look for the sidebar menu item using the label you configured, such as Alumni Community.

  3. 3

    Click the menu item.

  4. 4

    AlmaShines opens in a new tab and the trainee is signed in automatically without a separate login prompt.

Important Notes

  • Treat the API Key and API Secret like passwords. Store them securely and do not share them over email or chat.
  • After saving, the integration card on the Integrations page will show an Active status.
  • Trainees never see AlmaShines credentials. The LMS handles the SSO connection in the background.

Understanding Each Setting

Sidebar Menu Label

The text trainees see in the left navigation menu, such as Alumni Community or Community Hub.

API Key

Provided by AlmaShines and used to identify your organization.

API Secret

Provided by AlmaShines and used as the secure secret paired with your API Key.

Require Course Completion

If set to Yes, only trainees enrolled in at least one active course can see the menu item. If set to No, all trainees can see it.

Status

In edit mode, Active keeps the integration live, while Disabled hides the menu item without deleting the configuration.

What the Trainee Sees

  • The configured menu item appears in the left sidebar with other navigation links.
  • On the first visit, the LMS creates the trainee’s AlmaShines account in the background if one does not already exist.
  • On later visits, the existing account is reused and the redirect is faster.
  • If Require Course Completion is set to Yes, the menu item disappears when the trainee is no longer enrolled in any active course.

Day-to-Day Management

  • Change the menu label: Go to Integrations → AlmaShines, click Edit, update the label, and click Update.
  • Rotate API credentials: Obtain new credentials from AlmaShines, open the integration form, replace the old values, and click Update.
  • Temporarily disable the integration: Set Status to Disabled and click Update. Re-enable it later by switching Status back to Active.
  • Remove the integration entirely: Contact your LMS technical team. This removes the LMS connection only and does not delete AlmaShines community data.

Troubleshooting

Issue What to Check
Menu item not visible to a trainee Check that the integration is Active and that the trainee has an active enrollment if Require Course Completion is set to Yes.
Menu item visible to all trainees even when Require Course Completion is enabled Open the integration form, click Edit, confirm the setting is saved correctly, and click Update.
Unable to connect when the trainee clicks the link The API Key or API Secret may be incorrect or expired. Generate new credentials in AlmaShines and update them in LMS.
Trainee sees the AlmaShines login page instead of being signed in automatically Ask them to click the menu item again so a fresh one-time SSO link is generated.
New tab does not open The browser popup blocker may be preventing AlmaShines from opening. Allow popups for the LMS domain and try again.