MIRC Powerpoint Tool

From MircWiki
Jump to: navigation, search

PPT2MIRC is a Powerpoint plug-in that saves a Powerpoint presentation as a MIRCdocument on a MIRC site, allowing the presentation to be found through normal MIRC queries. It was written by Scott Keller, based on work done by Prof. Amilcare Gentili of UCSD.

PPT2MIRC requires Windows XP or better to run because it uses the system zip folder feature. It has only been tested on Powerpoint 2003, although it may run on older versions.

PPT2MIRC now works only with MIRC T33e or later. The reason is that in order to improve the performance when converting large Powerpoint presentations, it was necessary to change the structure of the zip file that is transmitted from the Powerpoint application to MIRC. Older versions of MIRC will reject this file because it contains a subdirectory.

PPT2MIRC creates a page-mode document containing standard MIRC elements (title, author, abstract, etc.), a link to the presentation itself, images of each of the slides, and an invisible section containing the text from all the slides and notes pages, allowing the presentation to be found by searching for any of the text on any of the slides or notes pages. The link to the presentation allows the user to retrieve the original Powerpoint presentation from the MIRC site.

1 Installation

After downloading the Powerpoint Tool zip file, open the file and extract PPT2MIRC.ppa.

Before it can be used, PPT2MIRC.ppa must be registered with Powerpoint as an add-in. Installing the add-in is a little different in the various versions of Powerpoint.

1.1 Powerpoint 2007 and 2010

  1. Launch PowerPoint.
  2. Click the File tab and select Options.
  3. In the PowerPoint Options dialog, clickthe Add-ins in the left pane.
  4. In the right pane, select 'PowerPoint Add-ins' from the Manage drop down and click 'Go...'
  5. On the Add-ins dialog, click 'Add New...' .
  6. Navigate to the PPT2MIRC.ppa file and click on OK.
  7. If a macro virus warning appears, enable the macros.

When the Add-in is properly loaded, it will display a tick against the add-in name.

1.2 Powerpoint 2003

The default location where Powerpoint 2003 looks for add-ins is C:\Documents and Settings\USERNAME\Application Data\Microsoft\AddIns, where USERNAME is to be replaced by your actual username.

After placing the file in the AddIns directory, you must set the security level for macros and then enable the add-in.

To set the security level:

  1. Run Powerpoint.
  2. In the menu bar, select Tools / Options.
  3. In the Options dialog, click the Security tab.
  4. Click the Macro Security... button.
  5. In the Security dialog, click the Security Level tab.
  6. Click the Medium radio button.
  7. Click the OK button on the Security dialog.
  8. Click the OK button on the Options dialog.
Error creating thumbnail: Unable to save thumbnail to destination
Error creating thumbnail: Unable to save thumbnail to destination

To enable the add-in:

  • In the menu bar, select Tools / Add-ins.
  • In the Add-Ins dialog, check the PPT2MIRC box if it appears; otherwise, click the Add New... button and navigate to the PPT2MIRC.ppa file.
  • Click the Close button.
Error creating thumbnail: Unable to save thumbnail to destination
Error creating thumbnail: Unable to save thumbnail to destination

2 Operation

To use PPT2MIRC, open a presentation in Powerpoint. In the Tools menu, select Convert to MIRC. A window will be displayed as shown to the right.

Fill in any of the fields you want.

  • The title field is automatically set to the title of the Powerpoint presentation. If you want to change the title of the MIRCdocument, edit this field.
  • Enter any text in the abstract field. This field is displayed in query results, so it is good form to place a short description of the document in this field.
  • Set the author and the various keywords fields so that the MIRCdocument reflects the presentation when it is included in query results.
  • In the Owner field, enter the username of the MIRC user who is to be the owner of the document.
  • Set the three access fields to determine whether others can read, update, or export the document.

Set the MIRC Address field to point to the MIRC site to which you want to submit the MIRCdocument. The form of the URL depends on whether the MIRC site is running on Tomcat or CTP.

The MIRC Address of a Tomcat/MIRC site has the form: http://IP:port/storage/submit/doc?ppt, where storage is the name of the storage service intended to store the document. (If you aren't sure what the name of your storage service is, go to the query page for the site, select the Submit Service for the desired Storage Service, and look in the browser's address bar.)
The MIRC Address of a CTP/MIRC site has the form: http://IP:port/submit/ss1?ppt, where ss1 is the ID of the storage service intended to store the document. Each Storage Service (called a library in the latest versions) has a unique ID in the form ss followed by an integer. You can find the ID of a library by looking at the URL of a document that it contains.

IMPORTANT: For both Tomcat/MIRC and CTP/MIRC sites, the MIRC Address field must include the ppt query parameter.

When you have set all the fields the way you want, click the Send button on the MIRC Address line.

PPT2MIRC will then create the MIRCdocument and the images of the slides and then challenge you for your username and password on the MIRC site. PPT2MIRC will then submit everything to the MIRC site. The result will be displayed in the dialog window.

Once the document is on the MIRC site, you can find it by searching for any text in the slides, and you can edit it using the author service.