Note*
In order to perform this step you need to be an administrator of your O365 Tenant.

  1. Verify that the App Catalog exist in your tenant. If not, the first step is to create the App Catalog site collection.

    Example of the typical path to the App Catalog:
    https://tenant.sharepoint.com/sites/apps/SitePages/Home.aspx

  2. Sign in to Office 365 as an admin.
  3. From the app launcher menu (in the upper-left corner), select Admin to open the Office 365 admin center.

    Connect to your tenant's admin URL
  4. In the left pane, select Admin centers > SharePoint

  5. Select SharePoint from Admin centers menu
  6. In the SharePoint Admin Center select More Features in the left pane, and open Apps from the right pane.

  7. Select apps in the left pane
  8. Select App Catalog. If the App Catalog site doesn't open, select Create a new app catalog site, and then select OK.
  9. Create a new app catalog site

  10. On the Create App Catalog Site Collection page, enter the required information, and then select OK.

    Create a new app catalog site collection

Note*
In order to perform this step you need to be an administrator of your O365 Tenant.

To make the solution available for installation in your tenant:

  1. Navigate to your App Catalog site.

    Example of a typical path to the App Catalog:
    https://tenant.sharepoint.com/sites/apps/SitePages/Home.aspx

  2. On the home page of the App Catalog site, select the tile labeled Distribute apps for SharePoint.

  3. Select the tile labeled Distribute apps for SharePoint
  4. Select New and browse to the extracted YourPackage.zip > SPFx_Solutions > O365 folder.

  5. Upload the MT-ModernTheme-01.sppkg and MT-ModernTheme-02.sppkg files, or drag them into the library one-by-one.

  6. When prompted, confirm that you trust the client-side solution MT-ModernTheme-01.sppkg, and MT-ModernTheme-02.sppkg by selecting Deploy for each of them separately.

    Confirm that you trust the client-side solution
  7. Click the Properties icon for the MT-Modern0Theme-01 app indicated below to open the Properties Dialog form.

  8. Open the Properties Dialog form
  9. In the Properties Dialog form enter:

  10. For Short Description enter:
    "Modern Duotones" SPFx theming solution for SharePoint modern sites.

    For Icon URL you use:
    https://sharepointpackages.com/images/images-MT_WP/app_icons/MT-App_Icon1.png

    An icon for SPFx solution
  11. For Type the description enter:
    "Modern Duotones" SPFx theming solution for SharePoint modern sites from MasterThemes Inc.

  12. For Publisher Name enter:
    MasterThemes Inc.

  13. Make sure the Enabled check box is selected so that users are able to add this app to sites.

  14. Make sure the Enabled check box is selected
  15. Click Save.

  16. Click the Properties icon for the MT-Modern0Theme-02 app indicated below to open the Properties Dialog form.

  17. Click the Properties icon
  18. In the Properties Dialog form enter:

  19. For Short Description enter:
    "Modern Monotones" SPFx theming solution for SharePoint modern sites.

    For Icon URL you use:
    https://sharepointpackages.com/images/images-MT_WP/app_icons/MT-App_Icon2.png

    An icon for SPFx solution
  20. For Type the description enter:
    "Modern Monotones" SPFx theming solution for SharePoint modern sites from MasterThemes Inc.

  21. For Publisher Name enter:
    MasterThemes Inc.

  22. Make sure the Enabled check box is selected so that users are able to add this app to sites.

  23. Make sure the Enabled check box is selected
  24. Click Save.

Note*
In order to perform this step you need to be an administrator of your O365 Tenant.

Important Note*

The SharePoint Starter Kit solution can be deployed either manually (recommended) or automatically. The automatic method of the installation creates additional site collections and adds extra extensions and components to SharePoint Online tenant that are not required for the templates enclosed in this package (YourPackage.zip).

For manual deployment perform the steps below.

For automatic deployment via SharePoint Online Provisioning Service go to:
https://provisioning.sharepointpnp.com/home/details?packageId=83f9ebe5-3569-462b-a112-cc44b49cf7c2


To deploy the SharePoint Starter Kit to the tenant App Catalog:

  1. Download the sharepoint-starter-kit.sppkg file from the sp-starter-kit GitHub repository to your Downloads folder:
    (https://github.com/SharePoint/sp-starter-kit/tree/master/package)

    You may also download it from:
    https://sharepointpackages.com/pub/sp-starter-kit/sharepoint-starter-kit.sppkg
  2. Navigate to your App Catalog site.

    Example of a typical path to the App Catalog:
    https://tenant.sharepoint.com/sites/apps/SitePages/Home.aspx

  3. On the home page of the App Catalog site, select the tile labeled Distribute apps for SharePoint.

  4. Select the tile labeled Distribute apps for SharePoint
  5. Select New, browse to the Downloads folder and upload the sharepoint-starter-kit.sppkg file, or drag it into the library.

  6. When prompted, select the Make this solution available to all sites in the organization check box and confirm that you trust the client-side solution sharepoint-starter-kit.sppkg by selecting Deploy.

  7. .

    Make the solution available to all sites in the organization and confirm that you trust the client-side solution

    Upload completed
  8. Verify no errors were thrown during solution deployment.
  9. Upload completed
  10. Navigate to SharePoint Admin Center to approve the API permissions:

    1) From the app launcher menu (in the upper-left corner), select Admin to open the Office 365 admin center.

    Connect to your tenant's admin URL

    2) In the left pane, select Admin centers > SharePoint.

    Select SharePoint from Admin centers menu
  11. In SharePoint Admin Center expand Advanced section and select API management to approve pending API requests.
  12. Select apps in the left pane
  13. Approve the Microsoft Graph permission requests by selecting each permission request and clicking Approve.

  14. Create a new app catalog site
  15. The pending permissions should now be approved.

  16. Create a new app catalog site
  17. Request a custom API key to Alpha Vantage o use the StockInformation Web Part.

    StockInformation Web Part:

    Create a new app catalog site

    The StockInformation Web Part uses the live stocks service provided by Alpha Advantage. To use it you need a software key, that you can ask for free to the API provider. You will simply need to go to the page to Claim your API Key, fill in the form, and store the generated key in a safe place.

    The key should be configured at tenant level, by creating a storage entity using the following PowerShell script:

    Set-PnPStorageEntity -Key "PnP-Portal-AlphaVantage-API-Key" -Value "your-api-key" -Comment "API Key for Alpha Advantage REST Stock service" -Description "API Key for Alpha Advantage REST Stock service"


To configure your API Key:

    Make sure that you have the latest version of the SharePoint Online Management Shell available on the Microsoft Download site.

  1. Run the SharePoint Online Management Shell as Administrator (right-click on the icon).

    Run SharePoint Online Management Shell as Administrator
  2. Install the PnP PowerShell for SharePoint Online running the following cmdlet:

    Install-Module SharePointPnPPowerShellOnline

    Confirm that you want to install the modules from 'PSGallery' by typing Y and pressing enter:

    Enable scripting capabilities on your site
  3. Connect to SharePoint Online tenant using thfollowing cmdlet:

  4. Connect-PnPOnline -Url  https://tenant-admin.sharepoint.com -credential $credential

    When the Sign in window pops up, use your admin credentials to log in:

    e.g.
    administrator@tenant.onmicrosoft.com

  5. Configure your API Key by running the following cmdlet:

    Set-PnPStorageEntity -Key "PnP-Portal-AlphaVantage-API-Key" -Value "your-api-key" -Comment "API Key for Alpha Advantage REST Stock service" -Description "API Key for Alpha Advantage REST Stock service"

Important Note*

Note*
In order to perform this step you need to be an administrator of your O365 Tenant.

  1. In the SharePoint Admin Center select More Features in the left pane, and open Classic site collection page from the right pane.

  2. Select apps in the left pane
  3. On the Site Collections page select New > Private Site Collection.
  4. Create a new app catalog site
  5. In the new site collection dialog box for Title enter:
    MasterThemes Assets

    For Web Site Address leave /sites/ unchanged, and enter exactly:
    masterthemes-assets

  6. Important Note*
    The web site address of the MasterThemes Assets site collection must be https://
    [ tenant.sharepoint.com ]/sites/masterthemes-assets. If it is different, the collapsible footer and some other components provided with the package will be either missing or will not work correctly.

    Create a new app catalog site collection
  7. On the Site Collections page, open the newly created MasterThemes Assets site. The Template Selection page will open.

  8. Create a new app catalog site collection
  9. On the Template Selection page, navigate to Solution Gallery

  10. Create a new app catalog site collection
  11. In the Solutions Gallery, select Upload Solution > navigate to the extracted YourPackage.zip > MasterThemes_Assets > O365 folder, and upload the MasterThemes_Assets.wsp file.

    Make sure the uploaded solution is activated.

    Activate the uploaded solution
  12. Navigate back to the Template Selection page for the MasterThemes Assets site by removing /_catalogs/solutions/Forms/AllItems.aspx from your browser's address bar and hitting enter.

    Location of the MasterThemes Assets site:
    https:// [ tenant.sharepoint.com ] /sites/masterthemes-assets

  13. On the Template Selection page under Custom tab, select the MasterThemes Assets template and click OK.

    Click Custom tab, and select Modern Templates
  14. Under People and Groups > Set Up groups for this Site, create a group of members (Members of this Site) who will have rights to contribute content of the collapsible footer to SharePoint sites with applied Modern Duotones SPFx theming solution. Members with these rights can also be added to the MasterThemes Assets site at a later time.

    Select No for Navigation inheritance and click Create
    Select No for Navigation inheritance and click Create
  1. In your browser navigate to the site collection you want to install the SPFx Modern Theme app.

  2. Open the settings menu by clicking the gears icon on the top navigation bar, and then select Add an app to go to your Apps page.

  3. In the Search box, enter MT-Modern-Theme, and press Enter to filter your apps.

  4. Use Search to filter apps

    As a result, 2 apps should match your search: MT-Modern-Theme-01 (Modern Duotones), and MT-Modern-Theme-02 (Modern Monotones).

  5. Select ether the Modern Theme 01 (Modern Duotones) or MT-Modern-Theme-02 (Modern Monotones) to install the solution for your modern site.

  6. To check if either solution is installed on your site, wait a while and refresh your page (F5).

Copyright © 2019 MasterThemes Inc. All rights reserved.