Documentation

Sometimes you may wish to give authors the ability to leave a comment on their submission, just as readers can. To do this, first you must enable Author Comments in your Submission Type:

• Visit your Submission Type and click on the “Edit” button at the top-right to go into edit mode.
• On the General tab, scroll down to Author-Facing Settings, and set “Allow author comments” to YES.
• Click on the Save button at the bottom.

Now, when an author (who has submitted to this Submission Type) visits their submission status page, they will see a “Leave a comment” button that enables them to leave a comment on their submission.

When an author leaves a comment, the following people are notified via email:

• The author themselves
• The reader who has been assigned the submission, if any
• If no reader is assigned, then the Submission Type editor(s) are notified
• Any readers who are following comments on this submission

Important notes:

• When the submission is marked closed, authors can no longer leave a comment
• Authors can see all their comments on their status page, but no one else’s
• Author comments are marked and highlighted on the submission page
• Authors are limited to two comments every twenty-four hours

Sometimes authors or publishers need to know an author’s legal name, which may be different from their byline. For example, the legal name of the byline “James Tiptree, Jr.” was “Alice B. Sheldon.”

Moksha allows you to store author legal names in addition to author names (bylines) of submissions.

To enable this feature, do the following:

• Visit the Submission Type where you want to enable the storing of legal names and click the “Edit” button.
• On the “General” tab, under Legal Name, set “Ask for Legal Name:” to “YES”
  
• Click “Save” at the bottom of the page to save your Submission Type settings.

Now in your submission form, you will see two fields for the author name instead of one, Byline and Legal Name:

In addition, submissions within that Submission Type will now display the Legal Name and Byline in the Details section:

Important Notes:

• If the Legal Name exists for an author, it will be shown in the submission details, even if the option has been turned off for that Submission Type
• Legal Names are associated with an author’s email address

 

 

 

You can have Moksha automatically email one or more addresses each time a new submission comes in. This might be useful, for example, to have your new Moksha submissions appear in your Discord server **.

To configure this, do the following:

1. Go to your Submission Type you wish to forward to Discord and click the “Edit” button at the top right.
2. Click on the “Workflow” tab on the left.
3. Scroll down to “New Submission Notifications” and click “Add Notification”.
4. Choose the email/reader you wish to send to and whether or not you want to send an attachment.
5. Click the “Add” button to save.

Now when any new submission comes into this Submission Type, it will be automatically emailed to this address with or without an attachment.

A few notes:

• You will need to create the reader account if it doesn’t already exist.
• The reader account must have access to the submission type to receive a notification from that type.

** to integrate email with Discord, see the Zapier integration tool.

With Moksha, you can automatically forward a submission to a reader’s queue and notify multiple readers when a submission status changes. So for example, when a submission status changes to “needs second opinion” you can have Moksha automatically forward to the queue of Jane Q. Slusher and also have Moksha email readers Nora R. Editor and Dave M. Reader that the submission status has changed.

This might be useful in a situation where you want multiple readers to comment on a submission.

How To Use Automatic Forwards

1. Go to your Submission Type and click on the “Edit” button at the top right to go into edit mode.
2. Click on the “Workflow” tab on the left.
3. Scroll down to “Automatic Forwards”.
4. Click on “+ Add Forward” to add a new Automatic Forward.
5. Choose the status, whom to forward to, and which readers to notify.
6. Click the “Add” button to save the new Automatic Forward.
7. If you made any other changes to the Submission Type, click the “Save” button at the bottom.

Important note:

• Users can control whether or not they receive an attachment in their Profile, in their “Email Forwarding” settings.
• Users can control to which email the notification and/or attachments are sent in their “Email Forwarding” settings.

In Moksha, your particular instance is hosted under the moksha.io subdomain. For example, your site might be at mymagazine.moksha.io.

If you wish to change this subdomain to something else, for example, adifferentname.moksha.io, please contact us, and we can assist you with the transition.