TheMagPiMms

From eLinux.org
Jump to: navigation, search
TheMagPi.png

Main Readers Authors Volunteers Sponsors Advertising Translations


  • Quick start guide - A quick start guide to help new volunteers get the information they need.
  • Information for volunteers - A guide to help volunteers familiarize themselves with the team’s workflow / tools.
  • Information for authors - the process of submitting an article.
  • MagPi MMS - how to use the MagPi MMS.
  • MagPi GIT - how to use the MagPi GIT scripts.
  • Layout & fonts - description of the standard layout and associated fonts.
  • PDF creation - instructions for the generation of PDF for electronic and paper publication.


Introduction

The Magazine Management System (MMS) is a web application through which articles and associated issues of the magazine are tracked. The package allows comments to be attached to articles and tickets to be opened and closed. Articles can be assigned or unassigned from an issue. PDF files can be uploaded to an article record. All the PDF files in an article can be merged together on the server side. This dramatically reduces the time spent downloading and uploading files.


Registration

Registration is open to authors, layout team, testers and administrators of the magazine. To register, simply go to https://www.magpiweb.techjeeper.com/mms/auth/reg.php

Fill out the form (all fields are mandatory), make sure to enter the security code and lcick submit

When this has been done successfully you will be sent an email with a link to verify that you entered the email address and that you can receive emails from the MMS. Be sure to check spam folders. Make sure to white-list themagpi.mms.noreply@perfora.net and cgi-mailer@perfora.net.

The link will be something like https://www.magpiweb.techjeeper.com/mms/auth/conf.php?id=aL680enc2unXIds2sYKefQ

If you receive the error Invalid conf code. Please contact mmsadmin at themagpi.co.uk.

If successful you see: Username <you username> confirmed.

You will now need to wait until you have been authorised to access MMS.

Once access has been given you may login at https://www.magpiweb.techjeeper.com/mms/


How to navigate between issue and article views

The follow assumes you are logged, have just clicked the home link (top left), and there is at least one issue allocated to the language setting (top right (e.g. EN) you are currently using.

This is the 'issue view'.

The colour code at the top shows which colour is for which role.

For the issue table:-

  • Title - The title of the article
  • Page - The page the article starts on
  • # - Number of pages of the article
  • Type - type of article (e.g. advert, article, contents)
  • Master Status - This is the stage at which the article was last set to. This should be kept as up to date as possible.

The height of each article in the table below shows how many pages it takes up in the issue.

Depending on whether there are new comments and or open tickets on any of the articles you may not see any icons on the left of the issue table.

There are two icons that can appear here. This most left icon is to indicated the number of open tickets for that article. The icon that can appear just to the right of that will appear if any new comments have been posted since you last visited the article page (if you have never visited an article page it will appear if there is at least 1 comment).

There are two icons that can appear on the right of the issue table. The first icon to appear is the assignments link icon which is used to assign users to articles. The icon to the right indicates if the article is allowed to be merged into the issue pdf.


How to request a role

Navigate to the article page by either the articles menu at the top of the page or by clicking the article name in the issue table on the issue view page

On the left of the page there is a table titled Assignments | [History].

Each role is listed here.

To the right of each role will be two icons. One green and one orange. The green one is used to 'request' a role and the 'orange one' is used to say you are 'available is needed' to do that role.

Click the icon you wish for the role(s) you want. If this is successful you will see the icon you clicked and a red x to the right of it. click the x if you want remove you request.


Uploading pdfs

Navigate to the article page by either the articles menu at the top of the page or by clicking the article name in the issue table on the issue view page

Scroll down the page a bit and you will see something like: The number in (brackets) is the order in which the files will be merged/zipped. Current max file size is the lower of these two values 500M/500M.

You cannot upload files bigger than the value it says. You can only upload pdf files (please make sure they are valid pdf files before uploading).

There are two types of pdf you can upload. The pdf for the issuu(ISSUU) website and the other for printing(PUB).

The naming of the files is VERY important.

If the article name is Pi Pan then for issuu you upload PiPan-Page001.pdf as the first page of the article. For printing it is PiPan-pub-Page001.pdf. The upload system does not care about capitalisation.

To upload pdf's click any of the 'choose file' buttons and select your file. One file per button.

You can upload just one pdf if you wish.

Once all files have been chosen click the send files and be patient. The upload time is dependant on:-

pdf file size You current available upload bandwidth


How to make a comment

Navigate to the article page by either the articles menu at the top of the page or by clicking the article name in the issue table on the issue view page

Scroll down the page to the comment section.

the e-mail to box is there if you wish to send a copy of the comment by email to a user. This may be removed in the near future in favour of a different system.

below the email to box is another box. This box is where you type your comment. Once you are happy with your comment click post comment.

To reply to a comment click the Reply link next to the date of the comment. You then type your comment in the comment box and click post comment. If you then wish not to leave a reply just a normal comment click the leave a comment link.


How to reply to a comment

Navigate to the article page by either the articles menu at the top of the page or by clicking the article name in the issue table on the issue view page

Scroll down the page to the comment section.

To reply to a comment click the Reply link next to the date of the comment. You then type your comment in the comment box and click post comment. If you then wish not to leave a reply just a normal comment click the leave a comment link.

the e-mail to box is there if you wish to send a copy of the comment by email to a user. This may be removed in the near future in favour of a different system.

below the email to box is another box. This box is where you type your comment. Once you are happy with your comment click post comment.


How to post a ticket

Navigate to the article page by either the articles menu at the top of the page or by clicking the article name in the issue table on the issue view page

click create/open link from the ticket table on the right of the article page

You should now be on the create ticket page.

From the 'open an issue(ticket) as' list box choose the role (there may only be one option) that best represents who the ticket is coming from.

Enter a subject and an issue(ticket) description.

Click the for which the ticket is for.

You cannot open a ticket as and for the same role.


How to close a ticket

Navigate to the article page by either the articles menu at the top of the page or by clicking the article name in the issue table on the issue view page

click the ticket subject you want to close

You should now be on the ticket page.

click the update button

enter a message and click close ticket


How to update a ticket

Navigate to the article page by either the articles menu at the top of the page or by clicking the article name in the issue table on the issue view page

click the ticket subject you want to close

You should now be on the ticket page.

click the update button

enter a message and click update


Bug Tracker

If you find a bug within the MMS system or have an idea for a feature request / enhancement, these should be logged in The MagPi Bug Tracker for Nick to review.


You can also see the status of all outstanding issues / requests on the site.