Turn off the navigation menus on a MojoPortal page

strongeye — Mon, 03 May 2010 21:32:10 GMT

I needed to figure out how to turn off the navigation for the portal from my custom module. After some searching, I found code in Secure/Login.aspx.cs that did the trick.

The function to use is this:

SuppressAllMenus()

This function is part of MojoPortal.Web.mojoBasePage so pages that inherit from that will already have access to the function.

Bare bone layout.master for MojoPortal module development

strongeye — Sun, 10 Jan 2010 19:30:32 GMT

The code below is a bare bone Layout.Master master page for MojoPortal. I found that the default ones all still had some dependencies on MojoPortal. Since I'm trying to develop most of my features outside the portal (quicker build times), I needed to have something without dependencies that would still help me get something approximating the MojoPortal environment.

<%@ Master Language="C#" AutoEventWireup="true" CodeBehind="~/App_MasterPages/layout.Master.cs" %>

<!DOCTYPE html>

<html>

</head>

<body>

<asp:ScriptManager ID="ScriptManager1" EnablePageMethods="true" runat="server" />

<asp:contentplaceholder ID="pageEditContent" runat="server" Visible="false"></asp:contentplaceholder> 

<asp:Panel id="divCenter" runat="server" visible="true" cssclass="center-nomargins" SkinID="pnlPlain">

<asp:ContentPlaceHolder ID="mainContent" runat="server"></asp:ContentPlaceHolder>

</asp:Panel>

<asp:Panel id="divLeft" runat="server" cssclass="leftside" visible="True" SkinID="pnlPlain">

<asp:contentplaceholder ID="leftContent" runat="server"></asp:contentplaceholder>

</asp:Panel>

<asp:Panel id="divRight" runat="server" visible="true" cssclass="rightside" SkinID="pnlPlain">

<asp:contentplaceholder ID="rightContent" runat="server"></asp:contentplaceholder>

</asp:Panel>

</div>

</form>

</body>

</html>

MojoPortal starts up multiple Web servers in Visual Studio

strongeye — Wed, 06 Jan 2010 22:01:58 GMT

When debugging, you might see that MojoPortal starts up many different ASP.NET Web servers, one for each Web project. Hidden in the readme README.VisualStudio.txt included with the SVN trunk is the workaround. Good to know!!

Additional info:

You may notice when debugging that multiple web servers are spawned. This is because there are multiple web applications in the solution as features are split into separate projects. All the files for features get copied up to the main mojoPortal.Web project ie Web folder by post build events, so the feature projects are not meant to be run directly, the mojoPortal.Web project must always be the startup project, though you can set breakpoints and debug any of the code in any of the projects, but the main web project always has to be the startup project. You can disable those extra web apps from launching a web server as described here http://stackoverflow.com/questions/16363/how-do-you-configure-vs2008-to-only-open-one-webserver-in-a-solution-with-multi#16390

Just click the project node in Solution Explorer and then click the Properties tab on the right and you will see where to disable it. I have disabled them on my copy but it does not seem to persist those settings in the solution, they are apparently user specific.

Creating a MojoPortal module

strongeye — Wed, 16 Dec 2009 23:32:19 GMT

MojoPortal is an open-source content management platform that we have started using at StrongEye because it offers an extensive out of the box starting point for ASP.NET Web applications, and also because it is incredibly developer-friendly.

UPDATE: For most common Web site tasks, you probably can go very far in MojoPortal without having to create custom code. These steps are advanced and for developers who want to create new functionality that cannot be accomplished with the existing feature set that comes out-of-the-box with MojoPortal.

One of the first tasks that a developer needs to do to get started with MojoPortal is to create a module. Basically a module is a starting point for a 100% custom application. The module is the shim that plugs in to MojoPortal proper, and allows you to include a entry point to your application in context of the portal.

I have found the documentation to be great on the MojoPortal site, but there are lots of small details that are hidden inside tutorial videos and elsewhere. This post is an attempt to bring all these things into one place so you can get started.

UPDATE: This post is updated to include a bit more context than before. Before you begin step 1, you must first have a local copy of MojoPortal loaded from SVN per instructions here (note: this links to Windows instructions as that is my bias, Linux SVN instructions are here).

Once you have all the Mojoportal source code loaded locally, you need to set up you VS Solution. The simplest way to do this is to copy an existing .sln file from the code you just got from SVN and rename it so that it will not be overwritten when you do new updates from SVN to get newer versions in the future.

For the purpose of this entry, I am going to make a copy of "mojoportal_mssql_only.sln" and I'll rename it 'mojoportal-localdev_mssql_only.sln'. Then I'll open this file in Visual Studio. Getting the initial project to run locally is beyond the scope of this article, though this is something that you must have working before any of the steps below will work.

How to create a MojoPortal module

Step 1: Create the 3 initial projects

Category	Steps	Notes
Create UI project	Create a new ASP.NET Web Application [yourProject].UI Delete or rename the auto-generated Default.aspx file so it does not get copied to the portal by mistake. Create subfolders in your Web project for your controls and asp.net pages: /[yourProject]/ /[yourProject]/Controls/ Create a subfolder from the root of your Web project called "Setup: /Setup/	NOTE: don't create a new Web Site; what we want is a new Web Application. Right click Solution root > Add > New Project > ASP.NET Web Application Creating contents inside "Setup" is outside the scope of this article. See the developer documentation here for details on how to use the Setup system.
Create Business Layer project	Create a new Class Library project [yourProject].Business
Create Data Layer project	Create a new Class Library project [yourProject].Data Rename your .Data project to [yourProject].Data.MSSQL (or whatever db you are using). By naming it .Data initially, Visual Studio sets the target assembly name to .Data, renaming the project does not cause this to change, which is the desired behavior.	All the .Data projects that are variants targeting different database technologies should all compile to the same assembly name so they can be swapped at build time.
Add References in your Web UI project	· Log4net · mojoPortal.Business · mojoPortal.Business.WebHelpers · mojoPortal.Features.UI · mojoPortal.Net · mojoPortal.Web · mojoPortal.Web.Controls · mojoPortal.Web.Editor · mojoPortal.Web.Framework · [yourProject].Business
Add Reference in your [yourProject].Business project	· [yourProject].Data.MSSQL
Add .resx file for localization	Create a standard ASP.NET folder App_GlobalResources. In this folder, add a new .resx file by choosing Add > New Item > Resources file. Give the file a name matching your project name so that it is unique.

Step 2: Make your project mimic mojoPortal.Web enough that it will compile

Category

Steps

Notes

Update Web.Config

Open the Web.config file in mojoPortal.Web and copy the entire <pages> section in to your new [myProject].UI web.config

This section (<pages>) lives directly under <system.web> … your project may have an auto-generated section already. You can just overwrite the entire thing.

Copy Master Pages

Create a folder in your [myProject].UI project called “App_MasterPages”

Copy layout.Master from the WebStore.UI subfolder (this is preferable because it is a subset of the entire master page and it’s all that you need to develop). You can also simply copy the entire “App_MasterPages” folder from WebStore.UI (NOTE: NOT mojoPortal.Web! Important to use the folder from WebStore.UI instead!)

This gives your aspx pages the correct content placeholders when you develop your feature.

Step 3: Create your Module

The Module is an .ascx control that inherits from SiteModuleControl and creates the instance-specific entry point from the portal into your custom code. From this entry point, you may also have many other pages that are custom aspx pages that use the portal master page.

These steps rely on code generated by CodeSmith, which provides a free version on their site (here)

Category	Steps	Notes
Create Module ascx	In the folder created earlier in [yourProject].UI /[yourProject]/ Right click and create a new Web User Control (.ascx) called [yourProject]Module.ascx
Generate ascx from CodeSmith template	Open CodeSmith Studio. In Template Explorer, open the folder “Codesmith4x” found in \mojoportal\CodeSmith Templates\ Find the template called Mp_UI-starter_ModuleControlGenerator.cst Right click and choose “Execute” A dialog will open prompting you for values. Here is what to choose: Author: [your name] BusinessLayerNameSpace: [yourProject].Business ControlName: [yourModuleControlName] FeatureName: [yourProject] UINameSpace: [yourProject].UI Click “Generate”	The result of the generated code includes both control UI code and code-behind c# code. You will need to highlight each section separately to cut and paste.
Cut and paste back into your Module	Select the code beginning with comments // Author: [yourname] To the end. This is the code behind that goes in [yourModule]Module.ascx.cs Open [yourModule]Module.ascx.cs and replace all the code with the copied code. Save. Return to the generated Codesmith resulting code. In the .ascx source section, highlight ONLY the single line beginning with <%@ Control … %> Copy that and paste over the Source in your [yourModule]Module.ascx file. Save. Copy the remaining code between <%@ Control … %> and the code behind c# code comments from CodeSmith into your ascx source. Save.	The sequence and steps are designed here to work around a Visual Studio problem in which the “TitleControl” is not found. If you simply copy and paste everything all at once instead of following these steps, you may see the error: “The name ‘TitleControl’ does not exist in the current context” even though the control is there. As long as these conditions are true, you should not see that message: - You have the proper MojoPortal references set - You have updated the <pages> section in Web.config - You copy and paste the CodeSmith output in the correct sequence and Save in between steps.

Step 3: Add post-build logic to your Web project

This step integrates your code with mojoPortal with each successful build, so you can run the code and see it in context.

Category	Steps	Notes
Open the Properties of your .UI project	Right click on [yourProject].UI in Visual Studio Solution Explorer, choose “Properties”. Navigate to the Build Events tab.
Add Post-build event command line instructions to your .UI project	The purpose of this section is so that your code from your UI project will be automatically copied into the mojoportal project with each build. If you haven't used these, $(ProjectDir) and $(SolutionDir) are macros that Visual Studio recognizes. For more info about post-build events,see this article. Copy the commands below into the text box labeled “Post-build event command line:” and replace XXX with your project path names and YYY with your project names: xcopy /s /y "$(ProjectDir)bin\YYY.UI.dll" "$(SolutionDir)Web\bin\" xcopy /s /y "$(ProjectDir)bin\YYY.Business.dll" "$(SolutionDir)Web\bin\" xcopy /s /y "$(ProjectDir)bin\YYY.Data.dll" "$(SolutionDir)Web\bin\" xcopy /s /y "$(ProjectDir)XXX\.ashx" "$(SolutionDir)Web\XXX\" xcopy /s /y "$(ProjectDir)XXX\.ascx" "$(SolutionDir)Web\XXX\" xcopy /s /y "$(ProjectDir)XXX\.aspx" "$(SolutionDir)Web\XXX\" xcopy /s /y "$(ProjectDir)XXX\Controls\.ascx" "$(SolutionDir)Web\XXX\Controls\" xcopy /s /y "$(ProjectDir)App_GlobalResources\.resx" "$(SolutionDir)Web\App_GlobalResources\" xcopy /s /y "$(ProjectDir)Setup\" "$(SolutionDir)Web\Setup" Save after you have replaced the paths, right click your Web project and choose Properties. In the Build Events tab, click the Edit Post-build… button and you can paste this there.
Install your feature using the MojoPortal Administration tools	After you build your project, log in to MojoPortal as Administrator and navigate to this location: Administration > Advanced Tools > Feature Installation / Configuration You will see a list of all installed features, scroll down and click Add New Feature. On the new page, enter your module entry point path in Control Source. You may also choose resource files, icons, and other options here. Click Update. You may now add your new feature to a page.

After the steps above are completed, with my project, here is my solution structure in Visual Studio:

Steve Land

Turn off the navigation menus on a MojoPortal page

Bare bone layout.master for MojoPortal module development

MojoPortal starts up multiple Web servers in Visual Studio

Creating a MojoPortal module