Managing Licenses
Understanding how licenses and projects relate is a key concept behind using the Marketplace. Once you're familiar with how the system works, you'll find it to be an easy way to manage stuff you've purchased.
Licenses
When you buy an add-on or theme from the concrete5.org Marketplace, you're purchasing a license to use it on one website. To see a list of all the licenses you own, visit your profile's licenses page.
Projects
Each website you connect to the Concrete CMS community is represented as a "project" in your user profile. You can see a list of all your projects by visiting your profile's project list page.
Assigning a License to Your Project
Go to your profile's project list page and click the name of your project. This will take you to the project page we want to work with.
On the project page, scroll down until you see the list of add-on and theme licenses currently assigned to this project.
At the bottom of the list, find the grey bar titled "Add item to this project" and a dropdown menu titled "Select a license." This menu lists every available license. An available license is one that is not assigned to any project.
At the bottom of the list, find the grey bar titled "Add item to this project" and a dropdown menu titled "Select a license." This menu lists every available license. An available license is one that is not assigned to any project.
To assign a license to your site, choose the add-on you want to use on your site from the dropdown menu and click the Associate button. That's it! The license is now assigned to your project.
To complete the installation process, log in to your site's dashboard and go to the Add Functionality tab. The add-on or theme should now be available for download.w
What if I don't see my license on the list?
Is the license already assigned to a project? On your profile's licenses page you may have noticed that below every license is the name of the project it's assigned to.
If it's not assigned to a project, no project will be listed and a "Download Archive" link will be present. This is a great way to figure out which project is using a particular add-on.
If you need to transfer a license from one project to the other, please check out this how-to: Transfer a License.
Releasing a License
If you accidentally assign an addon or theme license to the wrong site and want to assign it to a different one, here's a step by step outline of how to do this:
Release a License
-
Log in to marketplace.concretecms.com
-
View your active projects:
-
Click on the name of your old project to be taken to its Project Page.
-
On the Project Page, you'll see a list of Add-ons & Themes. Click the red button labeled "Release from Project".
- Now assign the license to your new project. Go back to your list of projects. Click the name of your new project to visit its project page. Select your add-on from the list under "Add Item to this Project" and click the Associate button.
- On the new site, go to Dashboard > Extend concrete5. Your add-on should appear under "Awaiting Installation."
Delete an old project page
If you no longer need your old project page, you can delete it from your concrete5.org profile. This will automatically release all licenses assigned to the project and make them available to be assigned to other projects. See the following how-to article: Delete a project page
Download an add-on
The source code of any add-on is available only if the license is unassigned. Your profile's Licenses page lists your purchases. A Download Archive link will appear along side the add-on's name if it's currently unassigned.
Licenses from Different Users
If you've bought a few add-ons with one user account-- say, from an old, abandoned project-- and now you want to use them on a new project, you'll need to add that user to your project's Management Team and re-assign the licenses. It's not a difficult process, but it can be a little confusing to describe. Keep in mind that we'll be doing most, if not all of these steps at the marketplace.concretecms.com website (not your site dashboard).
There are a couple of things we need to check before we begin. First, make sure you have access to both accounts: the old one with the licenses, and the new one with the project you're working on. If you don't remember a community.concretecms.com password, you can always reset it if you have access to the email account you signed up with.
Second, make sure you've released the add-on(s) from the old project.
Now we're ready:
-
Go to marketplace.concretecms.com and log in as the user that owns the new project.
-
View your list of current projects. Click the name of the new project to visit its Project Page.
-
Under Management Team, you'll see a list of users associated with the project. We'll be adding the old user here. In the text field under Add User to Management Team, type (or better yet, paste) the old user name and click Save. The old user account will be now appear on the list, and will be able to assign add-ons to this project.
-
Now we need to assign the licenses to the new project. This can only be done from the old user account profile. Log out of marketplace.concretecms.org and community.concretecms.com, then back log in as the old user.
-
View your list of projects. Note that the new project is now on the list. Click the title to visit the Project Page.
-
Select the license you want to transfer from the drop-down menu under "Add Item to this Project" and click Associate. The license is now assigned to the new project.
-
When you log into your Concrete site's dashboard, the add-on will now be available for download on the Add Functionality page.
Alternatively, you can download an archive of your unassigned add-ons by logging in with the user account that made the purchase and visiting your profile's Orders Page. To install a downloaded add-on manually, please read the directions on this page.
Project Pages
As you work with Concrete CMS, you'll likely want to connect your sites to your profile in order to easily download themes and add-ons. If you've connected more than a few sites, or duplicates of the same site, it might be desirable to "clean up" old projects that you're certain that you no longer need.
Let's get started
Go to your projects page to see a list of your projects. Here's mine, and as you can see, it's got a lot of old development sites listed:
Click the name of the project to visit your project page. I chose "Cool Site 1". Here's what the project page looks like:
Over on the sidebar at the right side of the page, find a link titled "Edit Project".
You'll go to the Project Properties page. Here, you can update a project's name, description, and its list of contributors:
Find a red button labeled "Delete Project". Click it.
You'll be asked to confirm. When you click "OK" in the popup confirmation window, your project will no longer be connected to the Concrete CMS community.
Note: Keep in mind that this is your last chance to cancel-- so take a breath and make sure you want to delete it.
When I deleted the project, what happened to my project's licenses?
Any license assigned to the project at the time of deletion will be automatically released. They'll then be available to assign to other projects. Visit your Projects Page to get started.
When I deleted the project, what happened to the actual website?
Keep in mind that deleting a project does not delete a website. If your old project still exists out there in the wilds of the internet (or your local development environment), it won't just go away-- but it will lose its connection to our Marketplace. You won't be able to download new add-ons, or update any that are already installed on the site. When you visit Dashboard > Extend Concrete, you'll see a message like this at the bottom of the page:
To connect a deleted project to your profile again, you simply need to visit Dashboard > Extend Concrete > Connect to the Community and re-connect the site to your Concrete CMS profile.
This will be registered as a new, separate project. Also, keep in mind that you'll need to re-assign your licenses to the new project to get your site fully reconnected.