Shipping USPS

To Access: go to Extensions->Plugins and select type MyMuse. Open MyMuse Shipping USPS



Plugins MyMuse Shipping USPS   Plugin   Administration



Plugins MyMuse Shipping USPS   Description   Administration


Plugins MyMuse Shipping USPS   Connection   Administration

  • USPS shipping Username: Username you received at
  • USPS shipping Server: Production or Staging
  • Proxy Server: optional



Plugins MyMuse Shipping USPS   Misc   Administration

  • USPS Package Size: Regular, Large or Oversize.
  • Pad cart weight (include %): Pad the cart weight to allow additional weight for shipping box and packing for all USPS services. Requires you to have the % sign included. Example 15%
  • Machinable packages?:Is this package able to be handled by a machine. Default should be No.
  • Smart Flat Rate: If enabled the plugin will calculate if products fit into the appropriate flat rate box or envelope using the Largest Area First Fit algorithm. If products do not fit the flat rate box or envelope will not be an option. To ensure larger flat rate boxes/envelopes do not appear if products fit into a smaller option you MUST order the available flat rate methods from smallest to largest size.
  • Allow multiple boxes: If you would like to pack products into multiple boxes select YES. The maximum USPS weight per box will be the breakpoint. If Smart Flat Rate shipping is enabled the dimensions of the Flat Rate boxes and envelopes will also be used to break into multiple boxes.
  • Rate Type: Select the USPS rate type to offer to your customer. The options are RETAIL, COMMERCIAL ONLINE or COMMERCIAL PLUS rating. The default is RETAIL rates.
  • Report USPS Errors: Enabling the errors generated from the USPS service is useful when troubleshooting or to provide additional information to the shopper.
  • Debug: If set to yes, shipping data will be logged in the log folder.


Plugins MyMuse Shipping USPS   Option1   Administration

  • Published: Yes or no
  • USPS Shipment Service: Choose the service for this method.
  • Apply Handling Free: A flat dollar amount can be added to the shipping cost or a percentage amount can be applied to the shipping or total cart cost.
  • Handling Fee Amount: If you specified a handling fee type above then enter the dollar amount (example 2.00) or a percentage (example 5%).
  • Countries: Please select the countries for which this rate applies. If no country is selected, this rate will be applied for all countries.
  • Zip Range Start: Please enter the ZIP range start. If no value is entered for ZIP range start and Zip range stop, no zip condition will be applied.
  • Zip Range end: Please enter the ZIP range stop. If no value is entered for ZIP range start and Zip range stop, no zip condition will be applied.
  • Minimum order amount: Minimum order amount.
  • Maximum order amount: Maximum order amount.
  • Categories: If one product in the cart is associated to a category selected then the shipment is enabled.
  • Blocking Categories: If one product in the cart is associated to a category selected then the shipment will NOT be enabled.
  • Maximum packed boxes: This setting is used if 'Allow multiple boxes' option is set to 'Yes' in the plugin options. It will restrict this shipping method to a maximum number of packed boxes. For example, you may want to restrict the use of Small Flat Rate to 3 boxes. If '0' then there is no restriction.


You need Joomla 3.x and php 5.3.1 +

Here are Joomla's requirements.

If your site is not in English, You need a language pack for MyMuse in your language. If we do not have one contact us and we will start a translation.


If you are selling tracks, you will want the tracks themselves and a 'preview' version, often the first 30 seconds.

The tracks can be MP3 or WAV or FLAC or whatever you want.  You can sell multiple formats at different prices.
The previews are normally MP3's.

Where Do Files Go?

Where files go depends on your choices in setting up the store.


Create the category (artist) and product (album) and MyMuse will create the directories.

Then you can upload through the Edit Tracks page one at a time, or by FTP.  If you are using Amazon S3, go and upload all your files. Files uploaded by FTP/Amazon will show up in dropdowns in the Add/Edit Tracks screens.





Create subdirectories for formats and upload your files.



Once you upload all your files the file names will appear in a drop down in the tracks add/edit page.

For security, if using apache web server, and your download files are within the web directory, confirm there is a file .htaccess at the top of the download directory


The default is:

This should stop direct downloads of files.
If it is not there, you can copy it from administrator/components/com_mymuse/assets/htaccess.txt ->


Graphics: MyMuse creates a directory called images/A_MyMuseImages but you can put category/product images wherever you like.

What Do I Do First?

1) Go to Components->MyMuse->Store
and edit the settings there.



If you enter a description it can be pointed to with a menu of type MyMuse->MyMuse Store Layout
That view can also show any products labeled as featured, in a blog type layout.



You will want to edit the Contact Info.
You will want to upload your own logo and point to it in the Small Logo field.



This is the MyMuse CSS file loaded whenever MyMuse is. Change things as you see fit. You can include whatever you like in your main CSS and not load this, (Store Options->Disable CSS)



Formats: if you just sell MP3s, leave that as the only format. You can also choose to sell multiple versions, example: MP3 and WAV.
The customer will be able to choose the format. If you want different prices for each format, go to Pricing Options->Pricing Model and choose Price by Product.
Now you can set prices in each product for each format.

Download Directory/Download Directory Type: The default is to put files in subdirectories of Downloads Directory, using the artist name and album.


OR save your files By Format. The path then would be, for example


Make sure the Downloads Directory points to the full path to your directory. MyMuse will try to determine this on install. The default will be /path/to/your/site/images/A_MyMuseDownloads. There are many ways to find your full path if you don't know it.

If you set this to something else, make sure the directory exists and that the web server has permission to write to it.

Depending on your server set up, you may be able to put this outside your web directory for maximum security. You will have to use FTP to put files there as it will out of reach of the the Joomla Media Manager. 

Preview Directory/Previews all in one Directory: this is the relative path to the folder holding your previews. The default is to put files in subdirectories of Previews Directory, using the artist name and album.


You can set this to another path but it must be within the web directory.
You can set 'Previews all in one Directory'.

Upload Files: If you set 'Previews all in one Directory' and Download Directory Type: By Format, you can upload all your files to those directories and they will be available when creating albums and tracks.
If you do not, then you should create the artist categories and products first; MyMuse will create the sub-directories, then you can upload your files.



If you sell physical products, like CD'd, you probably want to turn on 'Use Shipping'. There are Shipping Plugins to handle the calculations.
'Add Shipping Automatically': if Yes and there is only one shipping option, it will be added so the customer does not have to click through another screen.
'Use Stock': Add Stock numbers to your products and deduct at sale time.
'Check Stock': If stock is at zero, stop the sale with a message.
'Add Zero Stock': Let the customer 'Backorder'. Orders with backordered items are marked in the Orders section.



Decide what kind of registration you want: Joomla, Full, No Registration. If you are selling physical items, you will want their address. Both Full and No Registration can gather that information. There are User Plugins to handle each one.



'Price by Track' lets you set a price for each track. Maybe some are longer or more valuable.
'Price by Product' lets you set the price, in each product, for the various formats you have.



'Owner Group': set which group will have access to its reports. Each artist needs a user account and must be assigned to this group.
'Cut to the Artist': What percentage should go to the artist. Is shown in reports.



'Shop Test': Any purchase goes through, emails are not sent.
'Debug MyMuse': various things, including Payment Plugin messages, are sent to the Debug Log at components/com_mymuse/log.txt


Optional: Add sample data. If you did not do this at install time, just go to the main MyMuse menu, also called 'Quick Start'. There will be a link to 'Install Sample data'.

Related Help Screen.

2) Go to Extensions->Plugins. Select Type->Mymuse.

  • - Choose the payment processors you want to be be live and enable them. You must also open them up and enter your personal data, for example your PayPal email for the PayPal plugin.
  • - If you turned on Shipping, choose the Shipping module you want

Related Help Screen.

3) Go to Extensions->Plugins. Select Type->User.

  • - Choose the user plugin you want to be be live and enable them..
  • - For Full Registration you want to enable User - MyMuse Profile.
  • - For No Registration you want to eneable User - MyMuse No Registration Profile.

Open the plugins to see what fields you want shown and required. 

If you do not want to create users, you can choose Registration Type: No Registration. Go to the Plugins->User and enable User - MyMuse No Registration" plugin. Open this plugin and choose what fields you want to capture. They will be saved in the "Notes" field of the order.

Related Help Screen.

4) Set the Options for the component.

On the main MyMuse screen there is an icon for "Options" on the top right. It is similar to the Joomla Article Options with the addition of product options. There are too many options :) but we hope the defaults are a good starting place.

Related Help Screen.

5) Make Categories to place your products under.

These can be the names of Artists or Genres or just MyMusic. I like to make a top level called MyMuse and two sub-categories called Artists and Genres. I assign artists' main category to be under Artists and additional categories under Genres.

Related Help Screen.

6) Make products!

Products can be physical (example: CD's) or just a parent (non-physical) to hold the description and the tracks or other items.
Add your tracks (downloadable) and/or other items (physical).

Related Help Screen.

7) Make menus.

  1. One or more menus that point to your Store and products. This could be a Store, Category or Product type menu
  2. A menu that points to the Shopping Cart
  3. Optional: A User Menu item that points to User Profile Edit Layout
  4. Optional: A MyMuse Item menu that points to  List My Orders
  5. Optional: A MyMuse menu that points to artists' sales report



It is recommended to make a copy of your site, for example at to test upgrading from 3.x to 4.x.

At the very least you should have a backup that you can revert to in case of problems. We recommend Akeeba Backup.


MyMuse uses Live Update from Akeebabackup. To get the new version, you must go to Components->MyMuse and click on Options at the top right. Enter your Download ID. from this site into the tab "Live Updates".

You can find your download ID on the invoice for your subscritiuon, or log in to this site and go to Subscribe->My Subscriptions. Find your current subscription and clcik "View Details".

Go to Components->MyMuse and you will see a notice when there is a new version. Click on UPDATE FOUND! CLICK TO UPDATE and click to install the update.

If you see the error "Unable to open archive
Extracting the update package failed. Please try updating the extension manually". Please click on "Refresh Update Information" and try again.

The software will be updated.

You can also come here and download the latest version. Install the latest version. It will detect that MyMuse is already installed and not touch the database, simply overwriting old files with the new ones.

IMPORTANT: open Components->MyMuse->Store and save once to establish new options.

MyMuse will save the css file as components/com_mymuse/assets/css/mymuse_old.css
If you have made changes there please compare the old and new to bring in your changes.