Bundles

From Dreamtsoft Wiki
Jump to: navigation, search

Overview

Dreamtsoft bundles serve as the primary navigation and storage reference for all development. Bundles can be thought of as "applications", similar to what you'd see on an iPhone. They allow you to navigate to a particular section of the platform, and within there view pages/components/buckets/CSS in whatever form that bundle's developer decided to arrange.

BUNDLEhomescreen.png

Creating a Bundle

  • Navigate to your site's bundles page, found at http://sitename.dreamtsoft.com/#/ds.base/bundles
  • Once you log in you will be at your bundle home page, from here click "Manage Bundles" at the top of your page
  • At the "Manage Bundles" menu, choose "Create a new bundle"
    • Bundle Name - lowercase (no spaces) name of your bundle ("my_bundle_name")
    • Title - Formal display name for your bundle ("My Bundle Name")
    • Vendor - choose your vendor record
    • Configure Remote - check the box if you'll be pushing this bundle to your own GIT repository
    • URL - https://github.com/account_name/repository_name
    • Username - The username for the account listed in the URL above
    • Password - The password for the account listed in the URL above

Loading Bundles

Dreamtsoft allows you to load bundles from remote repositories into your site

Loading a new bundle from the store

  • Navigate to your site's bundles page, found at http://sitename.dreamtsoft.com/#/ds.base/bundles
  • Click the "Manage Bundles" button at the top
  • At the "Manage Bundles" menu, choose "Load a new bundle from the store"
  • Select the appropriate "Vendor" at the top, causing the list of bundles to refresh
  • Find the bundle that you wish to load, and click the "Install" button on the right
  • You'll be taken back to the bundles screen, which should refresh
  • If your bundle doesn't show up after the loading screen disappears, refresh the screen yourself
  • Your bundle should now show up on the bundles screen, in the form of a new "bubble"

Loading a new bundle from a URL (external repository)

  • Navigate to your site's bundles page, found at http://sitename.dreamtsoft.com/#/ds.base/bundles
  • Click the "Manage Bundles" button at the top
  • At the "Manage Bundles" menu, choose "Load a new bundle from a URL"
    • URL - https://github.com/account_name/repository_name
    • Username - The username for the account listed in the URL above
    • Password - The password for the account listed in the URL above
  • Click the "Ok" button at the bottom of the screen
  • You'll be taken back to the bundles screen, which should refresh
  • If your bundle doesn't show up after the loading screen disappears, refresh the screen yourself
  • Your bundle should now show up on the bundles screen, in the form of a new "bubble"

Bundle Subscription

You can give certain spaces access to bundles through bundle subscriptions. If you are in your space tree view (option + S will get you there) click on the name of your space and then click "Manage bundles".
Bundle subscription.png

This will open a view of all the bundles that are available in that space and you can install, advertise, or give no access to the space you are in. Install will give you access to the bundle. Advertise will let any subspace or child space see that a the respective bundle is available for install. No access will make it so you cannot use the bundle and your child space will not see that the respective bundle is available for install. This feature is great for MSP's so that they can quickly grant or take away customers access to bundles.

Managing Bundles

Dreamtsoft bundle management is where 90% of your development efforts will take place. Whether making small changes to an action, or rewriting an entirely new data structure, the following directions will show you the way

Keeping an eye on the URL

Dreamtsoft keeps track of all changes made to the system, and flags those changes with the name of the bundle that the change was made in. This makes it easier to keep track of your development efforts, not forcing you to arbitrarily define "containers" for your changes. As a result, it's important to keep a close eye on the bundle that you're in at any given time, to ensure your changes will land in the right place.

To accomplish this (or if you ever get "lost"), simply take note of the URL at the top of your browser window, specifically the bundle portion of the URL. The URL will always be in the following format (bundle in bold):

Managing a bundle will generally be initiated through the clicking of one of two buttons, both located in the upper right corner of your screen while inside of your bundle


Bundle Configuration/Information

The information page allows you to set basic bundle parameters, like the title, banner, and theme. Certain slots won't be editable in this screen, as they're set only when a bundle is created and cannot be changed. To get here click the "gears" icon, then information

  • Title - the wording that shows up on the main Bundle selection screen
  • Vendor - locked down
  • Type - locked down
  • URL - locked down
  • Username - the username for the git repository where the bundle lives
  • Password - the password for the git repository where the bundle lives
  • ID - locked down
  • Icon - the image that shows up on the main Bundle selection screen
  • Theme - The CSS theme that the bundle will leverage
  • Banner - The custom banner that the bundle will leverage