# Integrating Unikname Connect with WordPress and WooCommerce

# What is Unikname Connect?

Unikname Connect is the easiest and safest authentication solution for any saas platforms and mobile apps. This solution have been designed for Saas platforms with users sensitive to the protection of their privacy, who want to be sure not to be tracked, and fleeing Facebook Connect or Sign In with Apple. Integrating Unikname Connect to your platforms will increase value proposition for your visitors, and will improve security. No more need to manage and to secure user's passwords and database!

# About WordPress and WooCommerce

WordPress

WordPress (WordPress.org) is a free and open-source content management system (CMS) written in PHP and paired with a MySQL or MariaDB database.

WordPress was originally created as a blog-publishing system but has evolved to support other types of web content including more traditional mailing lists and forums, media galleries, membership sites, learning management systems (LMS) and online stores. WordPress is used by more than 60 million websites, it is one of the most popular content management system solutions in use.

WooCommerce

WooCommerce is an open-source e-commerce plugin for WordPress. It is designed for small to large-sized online merchants using WordPress.

Table of Content

# Examples of integration with Unikname Connect

Many WordPress and WooCommerce websites are running with Unikname Connect, such as La Bande Du Coin, Cryptomaniac...

Look at them to see how they are using Unikname Connect to increase their business!

# Features of the plugin

  • Add Connect with your private @unikname button in WordPress screens: login, register, comment
  • Add Connect with your private @unikname button in WooCommerce screens: login, register, checkout

This plugin can also be used without the WooCommerce extension.

# Testing Unikname Connect with your own individual @unikname

After getting your individual @unikname, to can try it out on our partner's websites, such as:

# Registering your service

# Activation of Unikname Connect service

In order to activate Unikname Connect for your service, contact us by fill in the dedicated form.

We will contact you back as soon as possible.

# Check the received data

After being contacted by the Unikname Team, you should have the following information to go further:

  • your organization @unikname
  • the URL of the website you want to integrate with Unikname Connect
  • a pair of client_id/client_secret credentials to configure in your application
  • a coupon to get your organization @unikname

They are necessary to setup your account to display a such login screen when your clients will connect:

Example of organization @unikname on

# Your organization @unikname

Your users will see your organization @unikname when they connect on your service. For example, @Unikname-Forum above.

# The URL of your website

Your users will see your website URL when they connect on your service. For example, https://forum.unikname.com above.

# The client_id/client_secret credentials

These credentials will be necessary to configure the link between your service and Unikname Connect.

# The UNIK coupon

This information will be used to create your organization @unikname.

# Setup of your organization @unikname

To setup your organization @unikname, you first need to create it with the coupon.

Then go back here.

# Disclose your organization @unikname and verify the URL of your website

As shown before, your users will be able to check and verify information about your service. So you need to disclose and reveal them to the world.

They will be publicly readable in the UNS.network.

Use the uns CLI installed before to create your organization @unikname to disclose and verify your information:

# Disclose your @unikname

$ uns unik:disclose "@organization:MyCompany" -e "MyCompany"
Data to replace Explanation
MyCompany The @unikname you want to show to your users

# Verify your domain URL

Your domain URL will be verified in three steps:

  1. Generate a verification package.

    $ uns properties:register "@organization:MyCompany" --value "www.mycompany.com"

Data to replace Explanation
www.mycompany.com The URL of your website to verify.
⚠️ Do not include protocol. https will be used by default.

This command provides a verificationKey and write a verification package in uns-verification.txt file. It will be used in next steps.

  1. Expose the proof of ownership in your website:

In order to prove that you own your domain name, you will need to expose the generated verification package using one of the followings methods:

  • Html mode:

    Include the verificationKey in the HTML DOM of your website's landing page "https://www.mycompany.com/". The verificationKey can be placed in any html tag or in html source comments.

  • File mode:

    Upload the uns-verification.txt file to the following route of your website: "https://www.mycompany.com/.well-known/uns-verification.txt"

  1. Finalize the verification process:

Use the following command according chosen verification method. The uns-verification.txt file should be located in the directory of the command execution.

$ uns properties:verify "@organization:MyCompany" --url-channel {html, file}

This will add the "Verified/URL" property to your unik.

Thats it! You can check you information by looking for your organization @unikname in the UNS Network Explorer.

# Installation of the plugin

Unikname Connect plugin is available for free on the official WordPress plugins repository.

There are various ways of installing the plugin, so choose the one adapted to your installation:

  • From your WordPress Dashboard
  • From the Github repository
  • With Composer

# From your WordPress dashboard

You can install Unikname Connect from your WordPress Dashboard.

  1. Go to your WordPress Dashboard
  2. Go to the extensions/plugins manager
  3. Add a new one
  4. Look for unikname connect in the search box on right
  5. Install Unikname Connect plugin
  6. Then enable it

# From Github plugin repository

  1. Download WordPress-Unikname-Connect plugin tarball
  2. Extract the downloaded ZIP archive
  3. Upload the wordpress-unikname-connect-master directory to your /wp-content/plugins/ directory (you can remove the trailing -master in the name of the directory)
  4. Activate WordPress-Unikname-Connect from your Plugins page

# With Composer

If you're using Composer to manage WordPress, add WordPress-Unikname-Connect to your project's dependencies through the WordPress Packagist repository.

Run:

$ composer require wpackagist-plugin/unikname-connect

# Configuring your service

# Basic configuration

  1. Enable the Enable Unikname Connect
  2. Configure Unikname Connect @unikname with the information given from Unikname Team Support
  3. Configure Unikname Connect Secret with the information given from Unikname Team Support

Unikname Connect for WordPress basic configuration

# Advanced configuration

You can also configure some extra parameters in the Advanced tab of the plugin, such as displaying the Unikname Connect button on WooCommerce pages (see below).

Unikname Connect for WordPress advanced configuration, with configurations for WooCommerce

# Testing the integration

Just go to your service web site and click Connect with your private @unikname or Use your private @unikname. You should see the Unikname Login screen similar to this:

Unikname Login screen

# Troubleshooting

If you’re having issues when connecting (access denied ...), first ensure the credentials (@unikname, Unikname Connect secret, client id/secret ...) you are using to connect to Unikname Connect server are the good one.

Then, check that you’re using the latest version of all OpenID Connect SDK, library, plugin or service embedded in your application.

After that, if still you need help to integrate with Unikname Connect, you can get support on the Unikname Forum.