Đang tải... (xem toàn văn)
Hướng dẫn cài đặt và phát triển website trên dotnetnuke. Sử dụng Visual studio 2019 để tạo theme, tạo module mẫu theo mô hình MVC, cài đặt theme, cài đặt module đã được tạo.
Hướng dẫn cài đặt Code Theme Module với DotNetNuke Nguồn tài liệu tham khảo: - https://www.dnndocs.com/index.html https://christoc.com/Tutorials/DNN9-Tutorials Source Demo: Liên hệ hieplt.cs@gmail.com I Hướng dẫn cài đặt Có nhiều cách để cài đặt DNN, Cài đặt qua phần mềm: nvQuickSite (https://www.nvquicksite.com/) nvQuickSite tải cài thực số bước: + Tạo thư mục chứa cài cài đặt website DNN + Tạo Database MS SQL Server + Cấu hình site Link tải: https://github.com/nvisionative/nvQuickSite/releases/tag/v1.4.2 - Chọn phiên DNN cần cài đặt Next (sử dụng cài online) Có thể cài đặt từ file zip tải Sau ấn Next, hình chuyển qua cài đặt thơng tin website “Site info” Chọn Yes nến sử dụng cài máy tính (cài offline), chọn No muốn cài đặt Online (nvQuickSite download cài để cài đặt) (Giả sử trường hợp ta chọn Yes – Cài offline), - Một số thông tin quan trọng Site info: o Site Name (URL): nhập vào tên website bạn muốn tạo (domain), nvQuickSite tạo tên IIS site có tên tương ứng, thêm config vào file host window tương ứng với domain tạo cho máy local o Install Base Folder Instal Sub Folder: Thư mục chứa website tạo Ấn Next để tiếp tục cài đặt, Nếu thư mục chưa tạo có thơng báo sau: Ấn Yes để tiếp tục Màn hình cấu hình Database (SQL Server) xuất hiện, điền đầy đủ thông tin kế nối: - Database Server Name: Tên máy chủ Database - Chế độ xác thực Database, nên chọn sau nhập thơng tin đăng nhập Database Database Name: Tên CSDL để chứa liệu DNN (chỉ cần nhập tên, nvQuickSite tạo Database với tên tương ứng) Ấn Next để tiếp tục: Như trình cài đặt nvQuickSite kết thúc - Mở IIS thấy Site tinhvan.dnndev.me tạo ra: - Mở SQL Server thấy Database tạo: Ấn vào Visit Site để tiếp tục cài đặt DNN Framework Trình duyệt bật hình cài đặt với URL: http://tinhvan.dnndev.me/Install/InstallWizard.aspx - Domain: tinhvan.dnndev.me tạo theo tên điền vào phần cấu hình Site infor phần mềm nvQuickSite Link tham khảo bước cài đặt cấu hình: https://dnncommunity.org/How-To/-Download-and-Install Nhập thơng tin đê quản trị website: - Username: Tên đăng nhập cho tài khoản quản trị Password: Mật quản trị Email address: địa mail Website Name: Tên website Template: Giao diện website khởi tạo Language: Ngôn ngữ mặc định Database Information: Thơng tin cấu hình CSDL, chọn Default CSDL nvQuickSite cấu hình (Nếu có thay đổi chọn Custom để nhập lại thơng tin CSDL) Chuyển qua Tab Advanced, chọn Page Theme “TVT.DNN.Demo”, chọn Layout “neulayout”, chọn Page Container “blank” Ấn nút Add Page để thêm Page: Trang (Page) vừa tạo có hình dạng sau: Ấn vào biểu tượng khoanh tròn ảnh để mở chế độ chỉnh sửa giao diện (Thêm Module vào Page) thấy khung giao diện “Newlayout” vừa tạo bước trên: Như hoàn thành việc tạo cài đặt Theme áp dụng Theme cho Page Chúng ta thiết kế nhiều Layout Template khác theme để tăng tính tùy biến cho website III Hướng dẫn tạo cài đặt Module Tạo DNN Module - Từ Solution ta tạo thêm Project TVT.DNN.ModuleDemo, bắt đầu với ví dụ Demo Module MVC, kết nối đến CSDL lấy hiển thị danh sách Contact, Thêm Contact - Chuột phải vào Solution, chọn Add New Project… : - Trên hình Add a new project, gõ vào tìm kiếm chữ “dnn” sau chọn “DNN (DotNetNuke) 8/9 C# DAL2 MVC Module”, ấn Next để tiếp tục tạo Project Đặt tên Project: TVT.DNN.ModuleDemo, ấn Create để tạo Điền đầy đủ cac thông tin ấn OK, Project tạo, sau file Documentation.html bật ra, nên ý đọc kỹ phần hướng dẫn để cấu hình lại Project cho phù hợp với phiên DNN: - Một số điểm quan trọng file hướng dẫn sau: o Remove toàn Virtual Directory/ Application Site “tinhvan.dnndev.me” (tương tự bước tạo Theme) o Chuyển Target framework lên DotnetFramework 4.7.2 dùng DNN 9.5+, xóa file web.config - Mở References cấu trúc thư mục Project (Solution Explorer), kiểm tra thư viện có dấy chấm than cài đặt thư viện liên quan: - Mở NuGet gõ Dotnetnuke, cài đặt thêm thư viện (như ảnh dưới): o DotNetNuke.Core o DotNetNuke.Web.Mvc Sau cài đặt xong thư viện, xem xét cấu trúc mẫu Project tạo ra, có số file thư mục cần ý: - - Thư mục Models; Controllers; Views theo cấu trúc MVC Thư mục Providers chứa file Script Cơ sở liệu (Script Có thể tạo cấu trúc bảng liệu) Trong Ví dụ có file Script: o 01.00.00.SqlDataProvider: Tạo bảng có tên Contacts o 01.00.01.SqlDataProvider: Insert liệu mẫu vảo bảng Contacts o Uninstall.SqlDataProvider: Xóa bảng Contacts gỡ bỏ Module File “TVT.DNN.ModuleDemo.dnn” (hoặc *.dnn) để khai báo thông tin Module (tương tự với Theme) Thư mục “Components” chứa file tương tác kết nối với Cơ sở liệu Thư mục “BuildScripts” chứa file cấu hình đóng gói Module Để bắt đầu tạo file: Tạo Controller ứng dụng MVC thông thường: - Controller: ContactsController.cs với Method: Index Edit Models: Contacts.cs - View: Thư mục Contacts - Thư mục Components, tạo file: ContactRepository.cs để thao tác, kết nối với CSDL Khai báo file “ContactDemo.dnn”: - - Trong file *.dnn Đưa khai báo “TVT.Modules.ContactDemo.Controllers/Contacts/Index.mvc” lên đầu, khơng có ContrlKey Trong file ContactsController.cs viết lệnh ứng dụng MVC thơng thường (Xem code mẫu đính kèm) Một số ý viết code: - - Kế thừa class Controller: DnnController Tham khảo thêm số tham số link: https://www.dnndocs.com/content/tutorials/modules/mvc-modules/mvc-modulemvccontroller/index.html Với View có Model từ Controller truyền qua phải khai báo: @inherits DotNetNuke.Web.Mvc.Framework.DnnWebViewPage Link tham khảo: - https://www.dnndocs.com/content/tutorials/modules/mvc-modules/mvc-modulemvcviews/index.html Link tham khảo thêm: https://www.dnndocs.com/content/tutorials/modules/mvcmodules/mvc-module-project-overview/index.html Sau viết code xong cho Module, sửa chế độ Build từ Debug sang Release Build Project Khi Build thành công thấy file zip thư mục Install (Thư mục cấu hình file: BuildScripts\ModulePackage.targets) Cài đặt Module: Sau Build thành công Module, tiến hành cài đặt sử dụng Trên giao diện sau đăng nhập với tài khoản quản trị, vào SETTING Extentions Install Extention Giao diện cài đặt xuất sau: Kéo file Module vừa Build vào ấn Next Cứ tiếp tục Next hoàn thành, thấy tên Module vừa cài danh sách: Để sử dụng Module này, ấn biểu tượng phía cuối trang bên trái để mở tính cài đặt Module, góc bên trái trang có biểu tượng sau: Ấn biểu tượng khoanh đỏ trên, danh sách Module hiển thị, Chọn Module kéo vào trang: Thả Module vào vị trí mong muốn khung Layout Như hoàn thành cài đặt Module vừa tạo (kết hình dưới): ... Framework 4.7.2 Trong số trường hợp, DotNetNuke. Core không cài đặt vào Project (Hoặc không cài được) phải vào NuGet để cài thủ cơng: Trong hình trên, thấy có DotNetNuke DotNetNuke.Web.Client có hình... viện có dấy chấm than cài đặt thư viện liên quan: - Mở NuGet gõ Dotnetnuke, cài đặt thêm thư viện (như ảnh dưới): o DotNetNuke. Core o DotNetNuke. Web.Mvc Sau cài đặt xong thư viện, xem xét cấu trúc... Src="~/DesktopModules/DDRMenu/Menu.ascx" %> Những UserControl xây dựng với DNN lấy thơng