ASP-Nuke Installazione

Versione scaricata: v2.0.4
Ultima modifica: 19 Novembre 2004

Introduzione :

ASP-Nuke è un progetto di portale web gratuito, elaborato in ASP (VBScript). E' un progetto opensource e chiunque può utilizzarlo e modificarlo per aggiungere nuove funzionalità. Se quindi effettuate delle modifiche e volete farle includere nelle successive versioni dovrete comunicarlo. Questa documentazione permette di installare di ASP-Nuke per la prima volta.
 
Questa versione può lavorare con due tipi di database: "Microsoft Access" o "mySql".
 
Per maggiori informazioni consultate il sito ufficiale italiano ASP-Nuke.

1. Prerequisiti

Bisogna disporre di un server che esegua le pagine ASP affinché funzioni ASP-NUKE ad esempio : IIS 4.0 o superiori, PWS.
 
Se si vuole utilizzare mySql come database, occorre un server che ne supporti l'utilizzo e bisognerà farsi assegnare dal provider un database per l'utilizzo da parte del sito.

2. Installazione

Dopo aver scaricato e decompresso aspnuke204.zip, avrete : Copiate tutti i files della cartella "aspnuke" sul vostro server web (per esempio con un FTP). Non copiate la cartella "aspnuke" stessa, ma solo i file contenuti all'interno di essa, mantenendo la struttura delle cartelle!
Potete mettere il tutto sotto la "root" del vostro sito, oppure in una sottocartella.
Non copiate la cartella "docs" che vi serve solo per la documentazione.
Se avete scelto di utilizzare mySql, dovete prima creare il database e caricare i dati iniziali. Per fare questo, viene fornito il file "docs\mySql\crea_tabelle_mySql.sql" con le istruzioni SQL per creare tutte le tabelle del database e precaricare i dati essenziali. Per l'utilizzo di questo file con mySql, dovete consultare le informazioni fornite al riguardo dal vostro provider (di solito viene fornito un account "phpMyAdmin" con il quale è possibile eseguire il file contente le istruzioni SQL, direttamente sull'host). Se volete tradurre diciture, descrizioni, nomi, categorie, ecc., potete farlo semplicemente modificando questo file prima di eseguirlo.
 
Adesso bisogna aprire il browser ed andare sulla pagina setup_it.asp (es.: http://www.miosito.com/setup_it.asp se l'indirizzo del vostro sito fosse http://www.miosito.com). A questo punto sarete guidati per la configurazione del sito.
E' necessario inserire:
A questo punto premere il bottone "default" per compilare gli altri campi automaticamente, poi eventualmente modificateli come segue: Se si utilizza mySql, di solito si ha a disposizione un unico database; in questo caso indicare sempre lo stesso nome nei tre campi precedenti
Tutti i campi seguenti, ad esclusione di "Login" e "Password" devono sempre iniziare col percorso specificato nel campo Indirizzo principale del sito (impostato automaticamente dal bottone "default").

I file xml ed i database venono effettivamente copiati dalle cartelle in cui sono stati caricati alle cartelle specificate, che devono pertanto essere accessibili in scrittura. Le cartelle che i provider mettono a disposizione per i db hanno generalmente i diritti necessari.
Al termine dell'installazione, le cartelle in cui sono stati inizialmente caricati i db ed i file xml possono essere cancellate (contengono solo i file originali non configurati).
Le cartelle di upload specificate devono essere esistenti (non vengono create automaticamente) ed anch'esse accessibili in scrittura.
Ricordatevi di cancellare dopo la configurazione i file setup_xx.asp dal vostro sito web. Col setup creerete la figura dell'amministratore che sarà proprietario del sito in generale avendone tutti i diritti. Esiste un solo proprietario del sito generale, ma potrete aggiungere altri amministratori, con potere sulle varie aree del sito. Inoltre potrete cambiare i diritti degli utilizzatori del sito per accedere alla parte di amministrazione.
 
Dopo questa tappa il vostro server web sarà pronto ad accogliere i primi visitatori !

3. Mappa del sito

Adesso avrete a disposizione 8 cartelle (più altre sottocartelle) e dei file nella "root" principale :
 

4 . Note supplementari

Se non utilizzate il Calendario eventi, potete eliminarlo totalmente, con questi passi:
  1. Eliminate la visualizzaione del calendario dal menu di amministrazione "Blocchi grafici", deselezionando il flag "Calendario eventi" dai "Blocchi visibili"
  2. Eliminate eventuali riferimenti alle routines "DisplayCalendar" e "DisplayTopHomeEvents" da tutte le pagine (di solito da default.asp)
  3. Eliminate dalla "root" tutti i files denominati "calendar_xxx.asp"
  4. Eliminate il database Access "calendar.mdb" o le tabelle "calendar_xxx" dal database mySql
  5. Eliminate i files "calendar_xxx-inc.asp" dalla directory "includes"
  6. Eliminate la riga "<!-- #include file="calendar-inc.asp"-->" dai files "admin_includes-inc.asp", "includes-inc.asp" e "noblocks_includes-inc.asp" della directory "includes"

Se non utilizzate il Forum, potete eliminarlo con questi passi:

  1. Impostate la variabile di configurazione GLOBAL_FORUM_TOP a 0 per nascondere il link del forum dal menu
  2. Eliminate dalla "root" tutti i files denominati "forum_xxx.asp"
  3. Eliminate il database Access "forum.mdb"
  4. Eliminate i files "forum_xxx-inc.asp" dalla directory "includes"

5 . Migrazione da una versione precedente

migrazione da versione 1.2 a versione 2.0 con database Access:

  1. Installare ASP-NUKE 2.0 in una sottocartella nuova (NON nella stessa sottocartella dove si trova il vostro Aspnuke 1.2)
     
  2. Sostituite i db di ASP-NUKE con quelli del vostro Aspnuke 1.2
     
  3. Sostituite il tema di ASP-NUKE con quello del vostro Aspnuke 1.2
     
  4. "Loggatevi" come amministratore
     
  5. Lanciate la pagina "admin_updatemain.asp", che modifica il DB principale senza danneggiare i dati contenuti
     
  6. Lanciate la pagina "admin_updateforum.asp", che modifica il DB dei forum senza danneggiare i dati contenuti
     
  7. Se utilizzavate già il "Calendario eventi", installate il nuovo db Access "calendar.mdb" e copiate anche il vecchio db "eventi.mdb". Modificate, eventualmente la riga 23 del file "calendar_migratedb-inc.asp" che si trova nella directory "includes" (quella con l'istruzione Const OLD_DB_EVENTI = "eventi.mdb"), specificando il nome del db Access del calendario, se l'avevate modificato (se il nome è ancora eventi.mdb, questo passo non occorre). Lanciate la pagina "calendar_migratedb.asp" che riporterà tutti i dati dal vecchio al nuovo db, aggiungendo i campi nuovi. Quando la migrazione termina con successo (date prima un'occhiata!!), potete cancellare il vecchio database Access del calendario
     
  8. A questo punto avete un sito ASP-NUKE 2.0 base perfettamente funzionante con i dati del vostro precedente sito Aspnuke, ad esclusione degli eventuali blocchi aggiuntivi non standard, che dovrete adattare manualmente.
    Per i blocchi più diffusi verrano pubblicate le versioni per ASP-NUKE 2.0, in modo da ridurre al minimo i vostri interventi sul codice.

migrazione da versione 1.2 a versione 2.0 con database mySql:

La procedura migliore per passare da AspNuke 1.2 a AspNuke 2.0 con mySql è quella di procedere prima alla migrazione ad AspNuke 2.0 con db Access, come spiegato nel paragrafo precedente.
Una volta terminata la migrazione e verificato che il tutto funzioni senza cancellare il file "setup_it.asp", procedete come segue:
  1. "Loggatevi" con l'utenza e la password che vi sono state fornite dal provider al db mySql che vi è stato assegnato
  2. Lanciate (dall'opportuno pannello che vi verrà indicato nei file di help del provider) il file "crea_tabelle_mySql.sql" che si trova nella cartella "docs\mySql": questo script genera tutte le tabelle nel db mySql, popolandole con i valori di default (potete tradurre diciture, descrizioni, nomi, categorie modificando questo file, prima di lanciarlo)
  3. Per ogni tabella di Access (e per ogni database), i cui dati vanno riportati nella corrispondente tabella mySql, procedere come segue: in alternativa, se non vi funziona la procedure precedente, potete usare questa:
  4. Loggatevi di nuovo col db mySql e importate i dati generati con l'operazione precedente nelle tabelle mySql. A seconda della procedura usata, agite nel seguente modo:
Se mantenete per un po' i vecchi database Access, potrete verificare la correttezza dei dati, passando dalla gestione mySql alla gestione Access, semplicemente rinominando il due file di configurazione generati rispettivamente per i due database. Quando siete certi che tutto funzioni, cancellate i vecchi db Access (e la directory stessa, se risulta vuota), il file di configurazione di Access e i file setup_xx.asp.

6 . Tips (di Eduardo Besembel - besembel@cantv.net)

  1. Per l'invio di posta o newsletter devi cambiare nel file configuration.xml nella cartella xml i valori
    <translation name="GLOBAL_SITE_EMAIL">prova@prova.it</translation>
    <translation name="GLOBAL_ACCOUNTS_EMAIL">prova@prova.it</translation>
    cambiando prova con l'indirizzo di mail che vuoi utilizzare.
    Nel file originale è presente l'indirizzo di aspnuke italia.
  2. Se vuoi attivare o disattivare qualcosa, come l'editor web htmlarea, il pannello di controllo, ecc. nel file configuration.xml nella cartella xml ne hai la possibilità
    Ad esempio per l'editor htmlarea
    <translation name="GLOBAL_SITE_WYSIWYG_PATH">/htmlarea/</translation>
    <translation name="bWYSIWYGeditor">3</translation>>
    devi inserire il percorso dove hai installato htmlarea, in questo caso sta in una sottocartella della "root" /htmlarea/; se lo hai inserito sotto un'altra sottocartella, per esempio "editor", dovrai inserire il percorso /editor/htmlarea/, e poi attivarlo inserendo un "3" senza i doppi apici.
  3. Le immagini possono avere solo le seguenti estensioni: <translation name="imgExtensions">*.gif, *.bmp, *.jpg, *.jpeg, *.png</translation>
    Se vuoi aggiungere altri tipi di immagini, devi aggiungere le nuove estensioni tra i tipi generici:
    <translation name="allowedExtensions">*.txt, *.ace, *.pdf</translation>
    e caricarle per mezzo della pagina di Upload.
  4. I nomi dei tipi delle categorie non possono essere modificati tramite aspnuke, l'unico modo per farlo è accedendo direttamente al database nella tabella typescategories.
  5. Se stai installando Aspnuke su un server che tu amministri, assicurati per mezzo della console mmc di windows da cui controlli il servizio IIS che le cartelle (DB,XML,PUBLIC,PUBLIC/DYNABLOCK,/PUBLIC/UPLOAD,/PUBLIC/UPLOAD/USERS) abbiano i permessi di lettura e scrittura, inoltre con esplora risorse di windows entra nelle cartelle xml,db,public/dynablock (una alla volta, chiaramente), e seleziona tutti i file della cartella, fai click con il bottone destro, nelle proprietà seleziona il tab sicurezza ed assicurati che l'utente usato da IIS ("Internet guest user" o qualcosa del genere) abbia i diritti di lettura e scrittura.
  6. Anche le categorie del calendario non sono modificabili semplicemente, ed in questo caso la tabella da modificare è calendar_eventscat nel database calendar.mdb.

Per qualsiasi domanda, idea o precisazioni? Postate sul forum di ASP-Nuke oppure consultate le F.A.Q.
 
Iniziatore del progetto: Gaëtan Bouveret alias Gat, Webmaster del sito ASP-Nuke (webmaster@asp-nuke.com).
Traduzione a cura dello staff di aspnuke.it (webmaster@aspnuke.it), per maggiori info visitate il sito www.aspnuke.it
 
LICENZA : Questo programma è un free software. Potete ridistribuirlo e/o modificarlo sotto i termini della licenza GNU General Public License pubblicata dalla Free Software Foundation, in versione 2, o tutte le successive.