Web.config datoteka sadrži mnoge postavke konfiguracije za vašu instalaciju mojoPortal-a.
Većina postavki koje će vas interesirati smještene su u appSettings sekciji koja izgleda ovako:
<appSettings file="user.config">
<add key="MSSQLConnectionString" value="server=(local);UID=mojouser;PWD=mojo123;database=mojoportal" />
...većina postavki
</appSettings>
Veza (connection string) baze podataka je prva postavka na koju ćete trebati pripaziti i koju ćete trebati konfigurirati ispravno da bi mojoPortal radio. Većina postavki ima komentare u Web.config datoteci koji objašnjavaju njihovu upotrebu.
Korištenje user.config datoteke za lakšu nadogradnju
Primjetit ćete da u gore navedenom tekstu postoji dodatak na appSettings elementu imenovane datoteke, čija je vrijednost "user.config". Taj dodatak govori vremenu rada (runtime) ASP.NET-a da prvo pogleda u datoteku određenu za sve postavke u appSettings sekciji. Tako možete staviti vašu vezu u user.config datoteku i preko nje se neće moći upisivati kada sljedeći put nadogradite mojoPortal instalaciju. Veza u user.config-u će preći preko ili adutirati (trump) onu u Web.config-u. U osnovi appSettings u Web.config-u mogu biti standardni, dakle možete ih ostaviti kako jesu i namjestiti sva vaša podešavanja u user.config, kako ona ne bi bila prepisana preko novom Web.config datotekom tokom nadogradnje. Ne postoji user.config datoteka uključena sa mojoPortal-om, no postoji datoteka naziva user.config.sample u osnovi (root) weba koja može biti preimenovana u user.config i zatim uređena sa vašim prilagođenim postavkama.
Važna napomena:
Pripazite na to da ASP.NET vrijeme rada nadzire web.config datoteku da otkrije kada napravite promjene, no to neće nadzirati i samu user.config datoteku. Zato kada god napravite promjenu u user.config-u trebate urediti Web.config kako bi se registrirale promjene u user.config-u. Jednostavno otvorite Web.config datoteku, utipkajte razmak negdje i spremite ju.
Često postoje nove postavke u Web.config-u za nove verzije mojoPortal-a, tako da je važno uvijek upotrijebiti novu Web.config datoteku da dobijete bilo koje nove postavke. Korištenje user.config-a može ovo učiniti manje bolnim zato što ne morate nastaviti restaurirati (keep restoring) sve prilagođene postavke.
Ovdje je jedan važan odlomak u Web.config-u koji ćete trebati održavati svaki put, budući da ne postoji lak način da imate prilagođene prijelaze (overrides) u eksternoj datoteci. To je system.net sekcija koja sadrži mailSettings:
<system.net>
<mailSettings>
<smtp from="noreply@yourdomain.com">
<network
host="localhost"
port="25"
password=""
userName=""
/>
</smtp>
</mailSettings>
</system.net>
Većina sadržaja mojoPortal-a koriste smtp postavke koje vidite u appSettings sekciji, no neke izgradnje u ASP.NET sadržajima koriste ovaj odlomak. To je sadržaj obnavljanje lozinke (password recovery) i sadržaj koji šalje link verifikacije e-maila novim korisnicima kada se registriraju (ako je konfigurirano da zatraži potvrdu e-maila).
Jednom kada ste to ispravno konfigurirali, predlažemo vam da kopirate odlomak i unesete ga u odlomak isključenog komentara vaše user.config datoteke.
Možete odkomentirati stvari u user.config-u, i staviti ih u ove zagrade <!-- -->
Tako imate mjesto iz kojeg ćete ih moći kopirati kada ih budete trebali restaurati u novom Web.config-u nakon nadogradnje.
I još jedna završna napomena, nemojte se zanijeti i kopirati sve postavke sa appSettings sekcije u vašu user.config datoteku. Stavite stvari tamo gdje ne koristite standardne postavke. Nekad se standardne postavke s vremenom promjene pa vam se mogu dogoditi krivi standardi ako prebacite sve postavke u user.config. U user.config stavite samo one stvari koje podešavate sa dobrim razlogom.