Tạo Module DNN

– Dotnetnuke là 1 cổng thông tin portal.
– Các yếu tố cơ bản của portal (cổng thông tin)
+ website & website con
+ các trang (pages) trên wwebsite
+ Các vùng (trên 1 trang) gọi là Pane
+ Các porlet (chứa nội dung thông tin)

Ví dụ

http://thienan.vn/tintuc/tabid/55/id/6/Default.aspx

http://thienan.vn/tintuc/tabid/55/id/8/Default.aspx

http://thienan.vn/tintuc/tabid/55/id/16/Default.aspx

http://thienan.vn/tintuc/tabid/55/id/19/Default.aspx

http://thienan.vn/tintuc/tabid/55/id/20/Default.aspx

là 1 page có PageID=55.
Trong Page này, porlet chính giữa hiển thị nội dung = cách đọc trong CSDL tin tức có mã 6, 8, 16, 19, 20 …

Vì các porlet có cái load động theo URL, có cái load tĩnh nên nhu cầu cần có settings cho mỗi porlet. Settings là gì ? là phần cho phép người dùng chỉ định cách thức hiển thị thông tin cho mỗi porlet.

Quay lại với Page, chúng ta có thể thấy khái niệm Page trong DNN đơn giản là cái khung các Pane bố trí ra sao, trên mỗi Pane đó các porlet đặt và hiển thị nội dung thế nào -> Page là khung cho các vùng (Pane, Region)
—
Coding for food

Như vậy có thể thấy container là cái chỉ dùng để làm đẹp, nó giúp các porlet của website được trình bày một cách thống nhất. Cái Container này không phải lập trình, DNN đã làm hộ. Chúng ta chỉ làm việc viết cách hiển thị cái nội dung bên trong các container, việc viết code hiển thị nội dung bên trong là việc viết module cho DNN.
—
Coding for food

1 Module như vậy có thể có nhiều Control cùng có key = blank, tuy nhiên khuyến cáo là chúng ta chỉ nên dùng 1.
—
Coding for food

Câu lệnh trên cho phép chúng ta chui vào phần backend (quản lý), cho phép chúng ta gọi 1 control duy nhất là control có nhiệm vụ edit 1 tin tức.

Url cho phép chúng ta truy cập vào tầng frontend (tầng trình diễn)

http://thienan.vn/tintuc/tabid/55/id/19/Default.aspx

URL cho phép chúng ta vào backend (tầng quản lý)

http://localhost/Home/tabid/36/ctl/admin/mid/378/Default.aspx

chúng ta xem xét kỹ URL này

ctl/admin/mid/378/Default.aspx
=> ctl = “admin” (key) , mid = “378” (ModuleID)
=> truy cập vào module có mã 378 đọc ra usercontrol (file ascx) có key = “admin”

Như vậy có thể thấy backend và frontend khác nhau ở chỗ backend có phần …/ctl/xxx/mid/yyy…
tức là có giá trị của ctl và mid

các key thông dụng cho quản lý tin tức

key = “news_edit” sửa 1 tin tức
key = “news_add” thêm mới 1 tin
key = “news_publish” cho phép 1 tin được đăng hay không
key = “news_delete” xoá 1 tin tức mới
key = “news_view” xem nội dung 1 tin

Thông thường “news_view” -> “” vì key = (blank) có nghĩa là chúng ta có thể thêm control này (porlet) vào frontend (thêm porlet vào trang – webpage trình diễn nội dung)
—
Coding for food

VB
Public Partial Class EditHtml
Inherits DotNetNuke.Entities.Modules.PortalModuleBase

Để phần này không lỗi module của bạn phải Reference đến file dotnetnuke.dll (còn reference là làm thế nào thì các bác tự tìm hiểu)

Hình này mà các bác nhìn còn không hiểu thì anh em bó tay rồi.
—
Coding for food

Trong ascx settings này chúng ta phải viết 2 hàm (bắt buộc)

VB
Public Overrides Sub LoadSettings()
C#
public override void LoadSettings()

và

C#
public override void UpdateSettings()
VB
Public Overrides Sub UpdateSettings()

Trong này để ghi vào CSDL chúng ta dùng

VB
Dim objModules As New DotNetNuke.Entities.Modules.ModuleController
Dim objModule As DotNetNuke.Entities.Modules.ModuleInfo = objModules.GetModule(ModuleId, TabId, False)

‘Update Tab Module Settings
objModules.UpdateModuleSetting(ModuleId, “TEXTHTML_ReplaceTokens”, rblstReplaceTokens.SelectedValue)

C#
DotNetNuke.Entities.Modules.ModuleController objModules = new DotNetNuke.Entities.Modules.ModuleController();
objModules.UpdateModuleSetting(ModuleId, “newsid”, newsid.ToString());
objModules.UpdateModuleSetting(ModuleId, “limits”, txtLimits.Text);

Đọc ra thì thế nào

C#
txtLimits.Text = ModuleSettings[“limits”].ToString();
VB
rblstReplaceTokens.SelectedValue = CType(ModuleSettings(“TEXTHTML_ReplaceTokens”), Byte)
—
Coding for food

Để module chạy ngon, dll cần phải copy vào thư mục /dotnetnuke/bin/ còn làm thế nào thì anh em tự nghiên cứu nhá.

Tức là chúng ta sẽ có /dotnetnuke/bin/module.dll

Như vậy là đủ kiến thức để viết những module đầu tiên rồi, ví dụ module Hello world.

Để viết cần thực hiện

1/ tạo file ascx : hello.ascx
2/ tạo module = hello -> def = “hello” -> control key = blank control = hello.ascx
3/ dịch module Hello ra file hello.dll
4/ copy file hello.dll vào /dotnetnuke/bin/hello.dll
5/ chọn 1 page bất kỳ rồi add module hello vào trang đó.
—
Coding for food

B5: Add control vào Project Hello tên controll là Hello.ascx

B6: Buile Project Hello

=> Build thành công

Bước 7:F5 chạy website đăng nhập user Host thành công

Bước 8:Chọn Host -> Host Difinitions ->chọn Create new Module

Bước 9: Next vài lần Create new Module thành công

bước 10: Edit module vừa Creat New, thực hiện Add Difinition ,trỏ tới đường dẫn control source)

Bước 11: Quay ra trang chủ tạo một trang bất kỳ Add Module.

Trong combobox có tên module Hello hiện lên rồi nhưng khi add thì không thấy nằm lên trong trang

còn đây là toàn bộ codeB2 của control Helle

Imports DotNetNuke
Imports DotNetNuke.Services.Localization
Imports DotNetNuke.Security
Imports DotNetNuke.Security.Roles
Imports System.Collections.Generic

Partial Public Class Hello
Inherits DotNetNuke.Entities.Modules.ModuleSettingsBase
Implements Entities.Modules.IActionable

Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyBase.Load

End Sub

#Region “Optional Interfaces”

Public ReadOnly Property ModuleActions() As DotNetNuke.Entities.Modules.Actions.ModuleActionCollection Implements DotNetNuke.Entities.Modules.IActionable.ModuleActions
Get
Dim Actions As New Entities.Modules.Actions.ModuleActionCollection
Actions.Add(GetNextActionID, Localization.GetString(Entities.Modules.Actions.ModuleActionType.AddContent, LocalResourceFile), Entities.Modules.Actions.ModuleActionType.AddContent, “”, “”, EditUrl(), False, SecurityAccessLevel.Edit, True, False)
Return Actions
End Get
End Property

#End Region

End Class
—

Mình đã mất khá nhiều thời gian mà không tìm được ra lỗi này, bạn xem mình làm có thiếu cái gì không nhé, mình cảm ơn bạn nhiều

Inherits DotNetNuke.Entities.Modules.PortalModuleBase

Moi add duoc vao trang web

Con cai ModuleSettingsBase chi danh cho settings thôi

Với lại bạn viết code đơn giản thôi để còn thử.
File ascx

<%@ Control Language=”C#” AutoEventWireup=”true” CodeBehind=”hello.ascx.cs” Inherits=”helloworld.hello” %>
<asp:Label ID=”lblhello” runat=”server”></asp:Label>

File cs

using System;
using System.Data;
using System.Configuration;
using System.Collections;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;

namespace helloworld
{
public partial class hello : DotNetNuke.Entities.Modules.PortalModuleBase
{
protected void Page_Load(object sender, EventArgs e)
{
lblhello.Text = “hello world”;
}
}
}

Nhớ thêm nữa là khi cài module thì phải đặt key trắng mới hiển thị trên webpage được

Chúc bạn vui vẻ

3. References tới 2 cái dll là: DotNetNuke.dll và Microsoft.ApplicationBlocks.Data.dll

4. Xóa 2 cái file default.aspx và web.config

Tiếp theo là tạo module dựa theo cách làm of DNN…

Cảm ơn bác aspnet, bác rất nhiệt tình!
—