PkNews: NewsLetters System

Licenza

PkNews is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or any later version.

PkNews is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

Storia
Installazione
Aggiornamento
Configurazione
Gestione
Sviluppi Futuri

^Storia

• Ver 1.1.1a marzo 2006
  • corretto malfunzionamento con alcune impostazioni del server PHP
• Ver 1.1.0a settembre 2005
  • Aggiunto supporto multilaguage. creati i file italian e english. Ora chiunque puo' localizzare l'applicazione (prego inviare file di lingua all'autore)
  • Possibilità di personalizzare i messaggi di email direttamente nel file di linguaggio
  • nuova veste grafica
• Ver 1.0.3a maggio 2005
• aggiunto Feed/RSS (ringrazio Kai Blankenhorn www.bitfolge.de per la classe FeedCreator)
• aggiungo update_table-0.9-1.0.x.php da versione 0.9 a versioni 1.0.x
• evito di salvare signature in news in DB
• Ver 1.0.2a maggio 2005
  • Corretti alcuni errori di html
  • Visualizzazione numero iscritti per ogni newsletter
• Ver 1.0.1a aprile 2005
• Corretta mancata selezione newsletter in fase di invio news
• Ver 1.0a aprile 2005
• Creato il pannello di controllo per ogni utente. Ogni utente ora puo'  gestire le proprie iscrizioni e i propri dati. Un utente puo' iscriversi contemporaneamente a piu' newsletter e modificare successivamente l'indirizzo e/o le iscrizioni
• Aumentati i dati di un utente. Oltre alla provenienza, ora e' disponibile anche il campo cellulare (facoltativo) che in futuro permetterà l'invio di una notifica SMS all'utente per ogni news inviata (solo sui server abilitati)
• Un amministratore puo' gestire contemporaneamente piu' newsletter. Nell'elenco delle newsletters compare il menu di gestione di fianco ad  ogni news per cui è l'amministratore.
• Solo un amministratore puo' creare newsletter
• L'invio di una news puo' essere fatto contemporaneamente a piu' newsletter. In fase di composizione vengono chieste le newsletter a cui inviare (tra quelle di cui si è amministratore)
• Un amministratore può modificare i dati di una newsletter.
• Migliorato l'aspetto del progressivo per invio delle email
• Vers 0.9 ottobre 2004
  • Pagine di interfaccia validate W3 HTML 4.01
  • Notevolmente velocizzata la spedizione delle news. Ora viene spedito un blocco di 10 msg alla volta con indirizzi in BCC: anziche 1 msg alla volta con indirizzo in TO:
    Di conseguenza cambia il sistema di cancellazione che ora viene fatto tramite web. In ogni news viene mandato il link alla pagina in cui cancellarsi con impostazione della news relativa.
  • La cancellazione viene effettuata in due fasi: richiesta e conferma. La richiesta avviene inserendo nella form apposita l'indirizzo da cancellare. Questa fase si conclude con una mail di notifica all'indirizzo in cui viene indicato un link per la conferma della cancellazione definitiva dalla news.
  • Ogni cancellazione è seguita da una mail di notifica all'indirizzo eliminato
  • Inserito il campo nome associato all'email.Il campo è facoltativo
  • Possibilità di spedire news in formato HTML. Per ogni news puo essere scelto il formato di layout (TXT/HTML)
  • inserita la gestione della privacy ai vari livelli. E' possibile modificare la informativa editando il file privacy.html
  • Personalizzazione. Nuovi variabili per personalizzare il sistema tra cui il foglio di stile aggiuntivo da utilizzare, le keyword e description metatag da associare
  • verifica email : notevolmente migliorata la verifica correttezza email in fase di iscrizione. Ora di dispone di 2 livelli di verifica selezionabili in config.php. Il livello exist (su server Microsoft non è attivo) arriva a controllare che l'indirizzo indicato esiste realmente facendo connessione al server smtp associato . Questo livello esegue accessi al DNS per rilevare il MX record del dominio associato all'indirizzo e procede con un tentativo di connessione.
  • inserimento multiplo da parte dell'amministratore è seguito da una mail di notifica adeguata all'indirizzo appena iscritto con indicazione del link per la cancellazione diretta (non in due fasi)
  • migliorati i messaggi di cortesia
• Ver 0.1 mar 2002
  • Prima versione dell'applicazione. Robusto il funzionamento

^Installazione

• Copia tutti i file in una cartella a tua scelta ad esempio /pknews
  A questo punto l'indirizzo web sarà http:\\www.nomesito.xxx\pknews
• modifica il file config.php dopo averlo rinominato (vedi configurazione)
• crea le tabelle con create_table.php

Terminata la Installazione e configuazione si consiglia di eliminare dal server i file create_table.php e update_table*.php

^Aggiornamento

L'aggiornamento puo' essere fatto sovrascrivendo i file esistenti con quelli della nuova versione.

Il file config.php esistente non viene modifcato, procedere come segue
- copiare i parametri di configurazione nel config.php.dist distribuito con la nuova versione
- successivamente eliminare il vecchio config.php
- rinominare il nuovo (vedi configurazione).

A partire dalla versione 1.0.3a il formato dei parametri di configurazione e' differente dalla versioni precedenti, tuttavia il loro significato non cambia. Inoltre dalla versione 1.0.3a è stato inserito il Feed/RSS e di conseguenza ci sono alcuni nuovi parametri da configurare. Vedi in fondo alla configurazione.

Aggiornamento tabelle

Per passare dalla versione 0.9 alle versioni 1.0.x è necessario aggiornare le tabelle del database.
Dopo aver modificato e rinominato il file config.php si possono aggiornare le tabelle utilizzando il file update_table-0.9-1.0.x.php .La procedura e' automatica e non c'e' rischio di perdita di dati, perche' l'aggiornamento salva le tabelle esistenti rinominandole con il nome OLDnews_xxxx.

Se l'aggiornamento tabelle si conclude con successo tutto e' concluso e si puo ritornare ad utilizzare l'applicazione.

NOTA:
Rispetto alla versione 0.9 la versione 1.0.x utilizza un differente metodo di gestione delle newsletter. In precedenza ogni newsletter aveva un amministratore anche se in realtà questo era la stessa persona identificata dalla stessa username e password.
Con la nuova versione un amministratore puo' gestire contemporaneamente piu' newslettere senza dover fare continuamente logout e login.

In fase di aggiornamento tabelle la procedura e' in grado di raggruppare gli amministratori identici generandone uno solo titolare di tutte le newsletter degli amministratori raggruppati. Username e password non vengono modificati

La stessa oprazione viene eseguita sugli utenti

Terminata l'aggiornamento e configuazione si consiglia di eliminare dal server i file create_table.php e update_table*.php

^Configurazione

Copia il file config.php.dist in config.php
Apri il file config.php e modifica le variabili di configurazione:

ricorda di togliere il commento a define("_SENDMAIL",true) per inviare realmente le email. Alrimenti il sistema funziona ugualmente ma visualizza in una pagina web le email che verrebbero inviate
Disattivato e' utile per mettere a punto il sitema e fare delle prove

//define("_SENDMAIL",false); //non inviare mail utile per test
define("_SENDMAIL",true); //inviare mail

Si consiglia l'installazione di PhpMyAdmin per aggevolare l'accesso al database MySql

Feed/RSS:

Dalla versione 1.0.3a è disponibile la funzione Feed cioe' segnalibri dinamici che permettono di vedere le ultime notizie del tuo sito direttamente tra i segnalibri dei tuoi visitatori.
Il sistema genera anche una pagina RSS cioe' "ultime notizie" che viene aggiornata automaticamente quando scrivi una news.

Sia il Feed che RSS possono essere linkati in altre pagine sul tuo sito o addirittura incorporate da altri siti utilizzando la tecnologia XML linkando quindi il file feed.xml oppore RSS linkando il file rss.html

Infine puoi segnalare la presenza del Feed anche in altre pagine del tuo sito. Ad esempio la homepage. Per fare ciò devi inserire la seguente chiamata al feed nella sezione <head>...</head> della pagina

<head>
....
<link rel="alternate" type="application/rss+xml" 
  title="NewsLetters-Nome del tuo sito" href="http://WWW.TUOSITO.ORG/NEWSPATH/feed.xml">
....
</head>

Seguono i parametri di configurazione:

• true per attivare i feed, false per disattivare
  $cfg['feedOn']= true;


• description Truncation Size
  numero di caratteri della notizia da visualizzare nel feed 0 per non visualizzare la notizia ma solo il titolo
  $cfg['feedDescLen']= 0;


• Nome del file RSS da generare. Dare i permessi di scrittura a tutti su questo file
  $cfg['feedFile']= 'feed.xml';


• Nome del file RSS da generare. Dare i permessi di scrittura a tutti su questo file
  $cfg['rssFile']= 'rss.html';


• Numero di ultime notizie mostrate dal feed
  $cfg['feedLastNews']= 15;

NOTA:
siccome i due file Feed/RSS vengono generati automaticamente dal webserver è necessario che abbiano i permessi di scrittura a tutti (chmod 777) altrimenti verrà generato un errore e il sistema Feed/RSS non potrà funzionare.

^Gestione

^FAQ

• Quanti iscritti puo'contenere una newsletter ?
  dipende principalmente dal server su cui viene installato il sistema. Tuttavia ho potuto verificare il corretto funzionamento con 3.000 iscritti su servizio di hosting a basso costo.
  


• Posso inviare news in HTML?
  Si! Dalla versione 0.9 è possibile.
  Nell'uso professionale della posta elettronica l'utilizzo di email in formato HTML e' sconsigliato perche'  aumenta inutilmente la dimensione dei messaggi e sono di difficile lettura per coloro che hanno client di posta in formato testo (eh si... esiste ancora chi legge la posta da un terminale unix!)
  


• Posso inviare allegati nelle news?
  No... è probabile che in futuro ci sara' questa possibilita'... anche se a dire il vero un sistema di news dovrebbe inviare messaggi con notizie quanto piu' snelle possibili.
  


• Posso inviare immagini nelle news?
  Si e No
  ... puoi farlo utilizzando un messaggio in HTML e mettendo l'immagine con un link ad un'immagine  presente sul tuo sito... per intenderci con un  comando del genere
  

  Questo è il logo: <img src="http://www.pklab.net/kbase/pknews/img/newsletter.gif">
                           ^^^^indirizzo assouluto dell'immagine
  

  Ottieni questo risultato:
  
  Questo e' il logo:
  
  In questo caso chi riceve la news per vedere l'immagine deve essere collegato ad internet .
  Inoltre molti utenti avanzati impediscono al programma di posta elettronica  il caricamento di immagini remote perche' possono essere fonte di virus e data-mining... quindi in questo caso la tua immagine non verrebbe visualizzata.
  Torno a dire che una newsletter dovrebbe comunicare nel modo piu' semplice e immadiato possibile senza riempire di cose inutili gli iscritti 
  
• Ho provato ad inviare news in html (le ho scritte con un editor html e ho fatto copia e incolla nel form di spedizione), quando faccio l'anteprima va tutto bene (ad esempio si vede il testo scritto in grande e in verdana) ma quando la ricevo sulla posta usando il mio webmail il testo è normale. Pensavo che fosse un problema di impostazione del mio webmail ma, ho già ricevuto email in formato html e si vedono bene.
  lo style con client di posta tipo Mozilla funzionano perfettamente mentre l'uso degli style non e' sempre prevedibile con i vari sistemi di webmail ! al posto di style devi usare
  

  <font color="red" size=+3>Ciao</font> ecc...

  provalo !

• Le newsletter inviate hanno come oggetto una cosa tipo : [NOME]TITOLO
  Vorrei eliminare [NOME] e lasciare solo il TITOLO che di volta in volta inserisco, anche perché NOME è già nel mittente.
  in generale newletter e mlist hanno sempre una cosa del tipo [xxxx] nell'oggetto per rendere piu' agevole la distinzione tra i propri messaggi di posta e aiuta anche la creazione di un filtro automatico
  
  Comunque se vuoi eliminarlo apri il file function.php e modifica la seguente linea:
$subject = "[%NOME-NEWS%]".stripslashes("$subject");

  con questa:
$subject = stripslashes("$subject");



• Si può evitare l'invio del cookie? Lo so che ogni volta bisognerà rifare il login, ma così si evita, quando si usano pc pubblici, di lasciare aperta la porta per il successivo utente. Come posso fare?
  Per evitare quello che dici basta fare click su LOGOUT al termine delle tue operazioni... in questo modo i cookie venngono eliminati
  
  Altrimenti per il momento si puo' ridurre la durata del cookie al tempo che vuoi.
  vai in admin.php e cerca la riga:
  
setcookie("admin","$admin",time()+2592000);

2592000 sono i secondi di durata del cookie. Quindi per farlo scadere dopo 1 ora puoi sostituire il numero con 3600... in questo modo:
  
setcookie("admin","$admin",time()+3600); /* scade dopo 1 ora */

^Sviluppi Futuri

• Possibilità di sospensione di una newsletter
• Eliminazione di una newsletter
• Invio notifica nuova news via SMS
• editor visuale per composizione news  in HTML
• motore di ricerca interno alle news
• Possibilità di gestire news private, non consultabili via web.