Aiuto su PMC
English version
PMC (PowerMail Check) è una piccola utility che si installa nella System Status Bar (la parte più a destra della barra dei menu). Mediante un menu facilmente accessibile, dà informazioni aggiornate su quanti messaggi di posta elettronica ancora non letti siano elencati nel programma di posta elettronica che usate abitualmente.
Programmi di posta elettronica supportati
Al momento PMC supporta PowerMail e Apple Mail. Consultate la documentazione per gli sviluppatori per sapere come fare per supportare altri programmi di posta elettronica.
Il menu
Il menu di PMC è identificato da questa icona:
Cliccatevi sopra, ed apparirà un menu, che assomiglia grosso modo a questo (i dettagli dipendono da quali cartelle siano configurate nel vostro programma di posta elettronica):
Il primo gruppo di elementi è la lista delle cartelle che sono configurate nel vostro programma di posta elettronica e che servono per organizzare i vostri messaggi; accanto al nome di ogni cartella, un numero indica quanti messaggi siano ancora da leggere in quella cartella. Potete specificare quali cartelle elencare nel menu attraverso la finestra delle preferenze. Selezionando una di queste cartelle indicherete il suo numero di messaggi ancora da leggere accanto all'icona del menu, così che possiate tenere costantemente sotto controllo se ci sono novità in quella cartella senza aver bisogno di raggiungere il menu ed aprirlo per leggerne il contenuto. Potete anche decidere di mostrare, accanto all'icona del menu, il numero totale di messaggi ancora non letti o anche nulla, semplicemente selezionando l'apposito comando dal menu.
L'ultimo gruppo di comandi vi dà ulteriori controlli sull'applicazione: finestra di informazioni, finestra delle preferenze, questa pagina di aiuto, e uscire da PMC.
Impostare le preferenze
Ecco come si mostra la finestra delle preferenze:
La tabella elenca tutte le cartelle che sono configurate nel vostro programma di posta elettronica. Notate che la gerarchia delle cartelle non è conservata, quindi tutte le cartelle sono "allo stesso livello". Questo è in effetti un limite dell'implementazione attuale di PMC. Nel menu dell'applicazione verranno mostrate solo le cartelle che hanno un segno di spunta di fianco al loro nome (fate doppio click sulla casella per mettere o togliere il segno di spunta); attenzione però che se escludete una cartella di modo che non venga mostrata nel menu, anche tutte le sue sottocartelle (nel programma di posta elettronica) saranno escluse, anche se sono contrassegnate dal segno di spunta nella tabella. Potete aggiornare l'elenco delle cartelle mediante l'apposito pulsante sotto la tabella.
Il resto della finestra delle preferenze vi permette di decidere quanto spesso volete che PMC aggiorni il conteggio dei messaggi non letti (si tratta di un'operazione abbastanza impegnativa per il processore, quindi non impostate questo tempo troppo breve), quale programma di posta elettronica usate abitualmente tra quelli supportati, e se volete che PMC vada automaticamente a controllare se ci sono nuove versioni disponibili per il download.
Documentazione per gli sviluppatori
PMC può essere usato con qualunque programma di posta elettronica che supporti un certo insieme di comandi AppleScript; se volete aggiungere il supporto per un programma di posta elettronica che ancora non è supportato, questo è il posto giusto dove trovare tutte le informazioni che vi servono.
Il "cuore" di PMC è costituito da due script AppleScript. Potete trovarli nel pacchetto dell'applicazione (nel Finder, fate control-click o click-destro sull'icona di PMC e selezionate la voce "Mostra contenuto pacchetto"), nella cartella Contents/Resources/Scripts. Qui, una o più cartelle identificano tutti i programmi di posta elettronica che sono supportati. Prendiamo come esempio PowerMail. Aprite la cartella PowerMail e ispezionate i tre file che vi sono contenuti. Ecco in che cosa consistono:
- GetFoldersScript.txt: un documento di solo testo che contiene uno script AppleScript che comunica con PowerMail e restituisce una singola stringa di caratteri che contiene una lista separata da virgole con tutte le cartelle configurate in PowerMail.
- GetMailsScript.txt: un documento di solo testo che contiene uno script AppleScript che comunica con PowerMail e restituisce una singola stringa di caratteri che contiene una lista separata da virgole con le coppie nome della cartella/messaggi ancora da leggere. L'output di questo script è quindi qualche cosa del tipo: "Posta in entrata,5,Posta in uscita,0,Messaggi dalla Mamma,2,Cestino,5", che significa che ci sono 5 messaggi ancora da leggere nella cartella Posta in entrata, zero in quella Posta in uscita, 2 in quella Messaggi dalla Mamma e 5 in quella Cestino. All'inizio dello script, una lista (
excludeFolders) è definita e contiene solo un elemento speciale: "$$$". Questo codice speciale è usato da PMC per cercare nello script tre segni di dollaro (circondati da virgolette doppie) e sostituirli con la lista di cartelle che l'utente ha deciso di escludere tramite la finestra delle preferenze.
- credits.txt: un file di solo testo che contiene un numero qualunque di linee di testo (meglio se 2 o 3) con tutti i riconoscimenti necessari per quanto riguarda i due script di cui abbiamo appena parlato.
Quindi, che cosa dovete fare per supportare un altro programma di posta elettronica? Solo quattro cose:
- Create una nuova cartella nel pacchetto dell'applicazione, cartella /Contents/Resources/Scripts, assegnandole un titolo che ricordi il programma di posta elettronica a cui state aggiungendo supporto (ad esempiop Apple Mail).
- Create un nuovo file di solo testo denominato GetFoldersScript.txt, che contenga un codice AppleScript valido che comunichi con il programma di posta elettronica che state supportando e che restituisca una singola stringa di caratteri con una lista separata da virgole con tutte le cartelle configurate nel programma di posta elettronica. Il codice AppleScript può essere arbitrariamente complicato (o semplice), a patto che il suo output sia conforme con le specifiche indicate.
- Create un nuovo file di solo testo denominato GetMailsScript.txt, che contenga un codice AppleScript valido che comunichi con il programma di posta elettronica che state supportando e che restituisca una singola stringa di caratteri con una lista separata da virgole di coppie nome della cartella/messaggi da leggere. Il codice AppleScript può essere arbitrariamente complicato (o semplice), a patto che il suo output sia conforme con le specifiche indicate. Lo script deve inoltre supportare una lista di cartelle che devono essere escluse mediante una lista AppleScript che sia inizializzata con il singolo elemento
"$$$"; non usate questo codice speciale "$$$" altrove nello script, dal momento che PMC assume che l'unico e solo posto in cui lo trova è quello in cui deve rimpiazzarlo con la lista di cartelle che l'utente ha escluso.
- Create un nuovo file di solo testo denominato credits.txt.
Ora lanciate PMC (se non è già in esecuzione) e selezionate il nuovo programma di posta elettronica dal menu a comparsa nella finestra delle preferenze. Se i vostri script funzionano correttamente e volete includerli nella distribuzione ufficiale di PMC, per favore contattatemi.
Riconoscimenti
Codice di Marco Coïsson
I riconoscimenti per gli script che supportano ogni programma di posta elettronica sono mostrati nella finestra di informazioni di PMC.
Scaricare PMC
Potete scaricare liberamente PMC sotto forma di un file compresso .zip.
Licenza
PMC è freeware. Potete usarlo e distribuirlo liberamente, anche su Internet o su CD-ROM o DVD allegati a riviste. Non potete rivenderlo o guadagnarci dei soldi senza il mio permesso scritto. Non potete distribuire PMC se è stato modificato, anche nelle sue risorse o nella sua documentazione.
Sviluppare software costa tempo e denaro; sulla mia home page potete trovare i dettagli del mio account PayPal nel caso vogliate considerare la possibilità di una donazione in denaro.
Grazie per usare PMC!