MemoryStream(ref NicksBrain);

2011: My year in review

Sun, 01 Jan 2012 16:11:39 GMT

Wow, what a year, lots done, lots learnt, lots left to do… Here what my year has been like… (I will keep updating it as I remember exactly what ive done, long year!)

ITV

So lots have happened at ITV in the last year, to sum it up I took lead on delivering the .net solution for the ITV pay project, this was a huge deal for me as it is one of ITVs biggest projects, so for me to take lead on delivering it was big – but I couldn't have done it with out a great team behind me, and the fruits of our labour paid off when we saw pay content playing back thru the ITV player two days before Christmas, fantastic win.

Another big project for the .net team going forward is delivering a new pipeline for some new projects coming along, which is an exciting greenfield project, which means we start from the ground up.

Testing has also taken centre stage this year, I started teaching Feature File sessions which were fun and have been a massive driver behind pushing them to the rest of the business, but I have been so busy with my work in and out of ITV its been hard to fit them in, so something I must improve upon.

Mayneframe Computing

So in the later half of 2011 I started my own company called Mayneframe Computing (stole it from my dad) – I am still working out the details of where I want to take it, but its in a good position to deliver product in 2012.

Around the same time I landed a contract with a company in LA working on Orchard (more below), one of the sites is already live (http://www.spyoptic.com/) – with a few other ones to follow! – On top of that I am flying over to LA in a week to see them!! So stoked!!

I have another start-up in the fire with some friends delivering agile coaching, though this is just an idea at the moment… more about in the coming months!

Orchard Project

This year has been big in terms of Orchard for me – I have worked hard on delivering features to a brand new platform that is still being proved in the commercial sense. So what have I delivered this year?

(ripped from my CV)

Orchard Open Authentication – The aim of this project was to provide multiple authentication mechanisms to Orchard CMS. This project leveraged multiple 3^rd party project including DotNetOpenAuth, Linq2Twitter, Facebook C# SDK, and Microsoft Connect (Live ID). http://orchardopenauth.codeplex.com/

Orchard Forums – This project provides a forums module to the Orchard CMS stack. http://orchardforums.codeplex.com/

(this was not)

In September there was a community election for the Orchard Steering Committee, and I was one of the five that got elected (http://www.orchardproject.net/about) which for me shows that my hard work has paid off, and its something I have been really proud of.

Other highlights

- In May we went to Florida with some friends and saw others whist out there, Gary and Kim we love you guys!

- Discovering a club with a hot-tub!!, and seeing Twickenham bridge at 5am.

- Passed my Windows Forms Application Development Microsoft Exam.

- Met my target for saving for the year.

- Also been with Pens for 8 years. (This was added by request of the girlfriend!)

How to get your Awesome Dev workspace for Orchard CMS up and running 101

Fri, 09 Dec 2011 11:35:16 GMT

After watching twitter for the last couple of days, and with the additional of a couple other comments, I have decided to write this post.

What does this post assume… 2 things, You have Mercurial (+ Tortoise HG (Download Here)) and Visual Studio 2010.

Lets get going.

1. Create a new folder structure that resembles this.. D:\BlogPosts\Orchard

2. Right click on the Orchard Folder navigate via the sub menus to TortoiseHg –> Clone..

3. Details are..

Source: https://hg01.codeplex.com/orchard
Destination: D:\BlogPosts\Orchard

Hit Clone (This will take a while so make a cup of tea :))

4. Navigate to D:\BlogPosts\Orchard\src\ and open up Orchard.sln in Visual Studio

5. Hit F5 in Visual Studio

6. Welcome to Orchard.

Time to create your own area to allow easy maintenance.

1. Copy and paste Orchard.sln – rename Copy of Orchard.sln to MyNewAwesomeOrchardInstance.sln – Why do this? Its important to allow you to decrease merge pain from the main repo further down the line

2. Check in to your new repo thru the Tortoise Workbench - Always use your new solution.

Latest Orchard Forum Mock-Ups

Wed, 03 Aug 2011 20:57:42 GMT

I thought a quick update to the community as to where I am with an Orchard Forum Module. I have not come too much further from my first post in terms of features (http://www.themayneissue.com/memorystream/orchard-forums..-basic-functionality) but instead I have worked on more core issues rather than bulking out functionality as Orchard is about building modules right? so functionality can always be added later on.

So what do I have that’s new from the first post?

1. Enhanced Security – Still a work in progress.
2. Basic Styling – (Screenshots below).
3. Ability to Close a Thread or Forum.
4. Ability to mark a Thread as Sticky.
5. Ability to mark a Thread as a ‘Question’ or ‘Discussion’ - functionality to mark a post as a question is not there yet.
6. Show the Latest Post at both the Forum level and the Thread level.

Okay so here are some mock-ups. Feedback welcome!! (FYI Code: http://orchardforums.codeplex.com/)

/Forums

A list of all forums

/discussions

A list of threads under a forum.

/discussions/is-orchard-better-than-drupal

A list of Posts under a thread

So how do you mark a Thread as Sticky or Closed?

You need one of the two permissions ManageStickyThread or ManageOpenCloseThread – If you have one of these permissions then when you Create/Edit a thread then you will be able to see these options.

The Is Closed marker stops replies to Posts within the individual Thread
The Is Sticky marker but that thread at the top of the list of threads.

Where am I headed next?

1. Flag a post/thread for moderation – this includes a admin screen.
2. Move a thread to a different Forum

What am I thinking about?

1. Adding a category to a forum, so you can list Forums by category.
2. Easier method to reply to a post
3. Notes as to why a moderator would ‘Close’ or take action i.e. move thread – more information back to user.

Let me know what you think – download the code and play. http://orchardforums.codeplex.com/

Nick

Your development team is slow.. What can you do?

Mon, 25 Jul 2011 15:58:51 GMT

So you have a development team, yet turn around on a product is slow? You have heard the words agile and scrum, but there must be more? Here are a couple of areas that a development team should work on to not only increase the turn around of a end product, but also increase the quality of said product.

Testing

Get your developers writing tests.. get your BA’s, QA’s writing tests… get everyone evolved, if you do it right, it will be fun… if you do it wrong you risk alienating people…

BA’s and QA’s are the people who see the 10,000 foot view of the system and the people who ultimately test said system – get them to write your feature files. But what are feature files? A feature file is the living documentation of a system writing based on the Gherkin language (https://github.com/cucumber/cucumber/wiki), the chances are that your BA’s have be writing something similar all along and didn't even know it… get them involved, and once they have completed a feature file, get a developer to implement it and demo the outcome to the business this way they will feel involved with the system, and make them feel like they have contributed to the code base.

Remember I said that feature files were the 10,000 foot view of the system? Well if the feature files works… then the system should too? right?

So now to developers.. Get them doing TDD – If you think that writing a test doubles your work load – you may initially be correct, but in the long run you are completely and utterly wrong. TDD will increase code quality if done right and decrease mistakes and debugging of developers (who really wants to be a debugging developer right?) – If I have a test, I hardly ever need to debug code anymore because I know what my tests are doing, and because I have a well driven out design the code is easy to read. So here is one big fact you will have more test code than actual implementation code in your system – what does this mean? It means that for one line of business logic written, there is usually about 10 lines of test code written – this is a good thing, not a bad thing.

TDD is a discipline – Its hard to start, its hard to sell, its highly addictive once you start.

Have you ever heard the saying that you should always cover your back? testing, using feature files and writing unit tests are the perfect way for a development team to cover their backs from the business. Stay safe I say and write a test first.

Continuous integration

You cannot underestimate or put a price on a good continuous integration pipeline, because good ones are rare, require investment and are also PRICELESS – I'm going to reiterate this point good continuous integration pipelines are PRICELESS. A good pipeline is the difference between a fast turn around of code (a couple hours) to a slow turn around of the same piece of code (a couple of weeks – yes its true)

So what is the top notch pipeline? No one knows because I don’t think anyone is there yet. But these are some of the attributes of the best one I have seen…

1. Speed up compile time and test time – building through visual studio or other GUI is slow, so running a local task that compiles the entire solution, and runs all tests that are associated with the solution on the command line is quite essential – decrease compile and test time and you decrease over all roll out time.

2. A continuous integration and build management server picks up the check in to source control and runs the same task from step one. Remember a developers machine is usually full of crap (I should know), so make sure the continuous integrations server is as pure as possible.

3. One click deploys.. well this is something every team should be chomping at the bit to get, no one in their right mind would want to email MSIs or DLLs around to operations teams to deploy, this is 2011 not 1999… In fact it makes me mad even thinking about doing this. One click deploys are one of those milestones in a development teams history - imagine logging on to a build server, clicking one button, and all assets are automatically deployed out to a stage or live environment - Magic.

4. Automatically tagged deployments. One question people often wonder is what version of assets have been deployed to which environment? if you have a lot of environments this can get very confusing.. so when clicking that button that does the deployments, make sure that you have a process to tag that revision along with the servers, etc..

Continuous deployment is a huge milestone in a teams life cycle and should not be underestimated. If you want to buy off the business this is one of the big YES’s – a hard to sell, hard to implement procedure with a huge pay off. Have a read of http://www.avc.com/a_vc/2011/02/continuous-deployment.html which will help to not only sell it to your team, but to sell it to your business. Tests + CI = 4 minute bug fixes – Hooora!

Source Control

This is different for every team, every developer, every manager etc.. everyone likes what they like, and getting it right is a pain. I have used Visual Source Safe 6, TFS, Mercurial, and GIT, and I have to say that at the moment distributed source control such as Mercurial or GIT are the clear winners.

I can understand that source control is a contentious issue and that TFS is the holy grail of some development teams., before we move on, put this in to perspective, TFS Costs around £1350 a licence, mercurial is free – Enough said.

Configuration Files

Configuration… oh configuration, how I loath it and love it at the same time. Don’t get me wrong, configuration within a system is a good thing, it means you can change a system without having to change any code and do a recompile. So why do I loath it? Because pushing configuration to multiple servers can be a pain… and getting it right is in its very nature a pain! At Bath Spa university we used NAnt to xml poke values based on which button in the CI pipeline we pushed. At ITV we use yaml files which hold the configuration values within a type of hierarchy, the actual configuration files were then built at compile time. Very neat – yet still quite complicated.

If someone has a cool way to do configuration files based on servers etc, I would love to know!

Staging

Get a stage server that the business can see and roll out to it often. Companies often feel like development teams are like black holes, and that they only see their investment after weeks/months of development time. If you have a staging server the business can look at to see how progress is coming, this can help to reassure them that what they want are being delivered and hopefully reassure them that their investment is not being wasted.

If you have a CI Pipeline this should be easy to setup right?

How do I know I am doing this right?

So I have my Continuous Integration server, people are writing tests and I have some odd configuration gooey stuff that my developers are ensuring me is cutting edge, my clients love the fact that I am rolling out every 3 hours, so is this what you meant Nick? YES – and does it not feel good?

In my opinion if you do these steps, your time to deliver will be significantly decreased, after all is that not what we are all trying to strive for in the end?…

Starting work on OpenAuth module for Orchard CMS

Sat, 18 Jun 2011 16:44:30 GMT

So I have thrown the Idea back and forth, and after deciding I wasn't going to do any work on Open ID for Orchard, I have changed my mind! So I have set up a new codeplex project called orchardopenauth (http://orchardopenauth.codeplex.com/).

The first goal is to get an extensible Open ID implementation working inside of Orchard without having to change any of the Orchard base code.

If anyone would like in.. give me a shout – Either by email or twitter (@NicholasMayne)

Why OpenAuth? Why NOT OpenID?

Open ID is small part to a very large piece of the puzzle. I want this module to be more than just about Open ID, eventually I see a full implementation of the DotNetOpenAuth project within the Orchard Framework, though these are early days and I have only just started.

Any ideas!.. or feedback, please let me know!

BlogML module for Orchard 0.8 CMS released

Sat, 18 Jun 2011 16:44:30 GMT

Codeplex site: http://orchardblogml.codeplex.com

I have finally released the upgraded version of the BlogML module for all you happy bloggers. This version is intended to work only on Orchard 0.8, but never fear, there is still the 0.5 version of this module kicking around on the codeplex website so you can export your blogs out in your own time.

The new version has a lot of bug fixes, though I have not been able to solve the problem with timeouts on large files. I have provided support for zip files containing more than one xml file, so you are more than welcome to give that a go instead.

If you need a walk thru of the module, please refer to http://www.themayneissue.com/memorystream/blogml-module-for-orchard-0.5-cms-now-available

Release notes:

1. Upgraded to Orchard v0.8
2. Changed all pages to use the Razor syntax
3. Fixed bug that I was trying to import files that have no urls in, but this is actually correct behaviour, the code should have taken this in to account and used the title instead. Fix: Check for null urls, and use title instead.
4. Forced hard refresh of Orchard after blog import – this will force orchard to refresh cache stash of slugs.
5. Fixed issue where the date times would be overridden by orchard
6. Changed the way information is reported back to the user. A report will now be generated, and only errors will be show on the admin screen.
7. Provided support for zip files containing multiple xml files.

Orchard v0.8 Released

Sat, 18 Jun 2011 16:44:30 GMT

Well we have all been waiting for it!… Orchard v0.8 is released, excellent. Thanks a lot to the Orchard team, cant wait to dig my teeth in, and migrate my blog up to v0.8 from v0.5 (hoping there is a upgrade path – fingers crossed)

An email sent from Bradley Millington announced it today -

“Forgive the terse email, but I wanted to let you all know that the Orchard 0.8 release is officially live:

http://orchardproject.net
http://orchard.codeplex.com/releases/view/49388

The Outercurve Foundation will be publishing a blog post about the release early tomorrow.

We are especially proud of this release, as it finally brings the long-promised theme engine to life. We added widget support as the icing on the cake.

The docs for this release are a little behind, but we are working to catch up the docs as quickly as possible. In the meantime, the Orchard Discussions on codeplex are always good place to tap the expertise of the Orchard team to get your questions answered.

Enjoy!

Bradley (on behalf of the rest of the Orchard team)”

The current iteration delivered:

- Migration of existing themes and modules to new theming engine, new developer theme
- Theme packaging
- Widgets

All i can say is, what can I look forward to in the next iteration.

Taking a quick peek at Pre-Orchard v0.8

Sat, 18 Jun 2011 16:44:30 GMT

Okay, So i couldn't wait. I haven't downloaded the source code in a while and thought why not take a peek around.

I think the Orchard team has focused mainly on striping out their old theme engine to make place for the new old, and I have to say I am impressed. The new theme engine hangs off the work that the Razor boys have been doing along with support for WebMatrix – which is fantastic to see.

When I worked at Bath Spa, one or two people were talking about adopting WebMatrix and this made me feel a little uneasy mainly because Orchard at that point did not have built in support for it (And they were showing my VB.net examples), but now they do, I hope that the Bath Spa team keeps and eye out to see what they can do with it.

So I downloaded the latest revision on orchard off of codeplex to have a quick shifty (No Stu this is not the same as a Chiggy-Back), and I have to say that I like what I see.

The whole theme engine has been replaced with a brand new theme engine that in my eyes is a lot more extensible. At the moment I would say that the system its self is still rather simplistic, but where as before the scope of the theme engine was limited, this time around the Orchard team have made something which in my eyes can easily be turned in to something quite powerful and is not limited by previous limitations that were imposed on it.

With theming they have expanded on this notion of widgets which they introduced very early on with the module ‘futures.widgets’. It would appear that they have also introduced a very early concept of a ‘page canvas’ which is one of the features I wanted to see built. At ITV we have a great page canvas and I felt this is one of the ITVs CMS strong points, but with Orchard going this route, with the notion of widgets and widget pages, this leaves room for excitement. It would also appear that widgets can be inserted and displayed to different roles based on the concept of layers. The changeset I downloaded was slightly broken, so I cant screen shot creating a widget page.

There also is built in Email support, which is a fantastic feature that I hope to use on my own blog, so I can receive notifications of people who have commented. For all the people who have been emailing me about ideas for a Email Campaign CRM might want to think of adopting this as a first point of call?

More to come after I explore a little more.

What is Orchard CMS v0.5 missing

Sat, 18 Jun 2011 16:44:30 GMT

After working with Orchard for 10 months and talking to various people from the community via email and message boards, I thought I would write a post on what I think is missing, and in some places a quick brainstorm on how to implement it.

First I would like to say that the great thing I like about Orchard as a developer is the way the team has taken the time to get the separation of concerns correct from the beginning making the framework hugely extensible. I would say for the separation of concerns issue is very important, though there are certain areas I feel in orchard where they have not stayed true to this design practice, but as the system matures I can see them breaking these things out.

Orchard have started a user voice group here - http://orchard.uservoice.com/forums/50435-general so please visit and vote up ideas, though I feel I kind of wanted to do my own post, so here we go

1. Workflow

For me this article says it all http://www.intranetjournal.com/articles/200412/ij_12_03_04a.html

When implementing a CMS system, you look at how that system can integrate with your company and work to your needs. You implement a CMS for a need, usually to replace a current task that is inefficient, and by that standard you look at how that task can be mapped on to a CMS or any system that you are looking at replacing said task with.

A good CMS system should be able to reduce complexity but still allow internal processes to exist. Adding workflow allows user content to be better managed because you give the employees a clear and visible path thru a system (granted I have seen some bad workflows before – but this is what workflows should allow). With out workflow, I find it hard to see how companies will be able to map workflows or ‘a process of tasks’ on to Orchard.

I'm not sure how workflow could be built in, but what I would like to see is integration with Windows Workflow, or BizTalk (I know I know)… but from an enterprise company's perspective, its a big issue!!

I feel that this missing feature should have been a high ‘Should Have’ from day one when the new content types module was build, and that it could be one of the major disadvantages or headaches to adopting Orchard from a company perspective. (Obviously I know certain people will disagree)

2. Form Builder

A Form builder in my eyes is something that allows a user to fill in information about ones self, and then save that information somewhere. I think that the task should be done in conjunction with Workflow, why? you might ask –
Well, when working for Bath Spa University we needed to build a system that allows staff to edit content, and allows students to fill in forms. The students information would then go through a number of stages of registration until they received a confirmation email that they have been successful or unsuccessful – this in essence is a workflow with a number of forms on the front of it. I feel that If we had a form builder in the system already, life could have been a lot easier, to allow us to build the infrastructure underneath, rather than playing with text boxes and labels.

3. Gravatars

Could be a quick win for someone to come up with a nice module that either injects Gravatars into the comments module, or overwrites the default Comments module view with a gravatar view. For anyone who doesn't know what a gravatar is visit - http://en.gravatar.com/

If anyone has looked at Oxite before (http://oxite.codeplex.com), you maybe able to steal what they have done and integrate it in to Orchard. I previously did this in Orchard for Bath Spa, but forgot where exactly I left the code!!!… Opps.

Note: Initial profiles module brainstorming came from this thread: http://social.msdn.microsoft.com/Forums/en-SG/orcharddiscussions/thread/716799b3-36e1-4e76-99ad-c1d6e57ee369

4. An Enhanced user profiles module

So at present, quite a few people have been emailing me with ideas on how my profiles modules could be extended, and in the most part I completely agree. I remember when I was first thinking up the ideas and talking to Lou who works for Orchard about the whole user profiles system, and so I decided that at the time… this being January of course that I would evaluate Orchard and see how easy it is to create a module, and hence my user profiles module was born.

As time moved on, my module has not kept up with the natural progression of Orchard and so in real terms, has fallen behind, which in its self is a shame. I would love to see someone take this module taken forward.

5. Integration with Active Directory (or something along those lines)

From previous experience, I have noticed that a lot of information on staff and the such get wrapped up on systems like active directory - I think it would be nice to have something that would allow you to have a wrapper around AD, so if you are deploying Orchard on an internal system, then it should integrate directly with AD to pull and push information whenever it so needed, rather than have duplicate information which could become stale and out of date quite easily. The same module if written correctly, could also integrate with OpenID or any authentication pattern.

6. Reputation, points, badges, etc..

I think that a solution similar to stackoverflow or even the MSDN forum should be dreamt up. I think the module should be based around integration with the user content type. The tricky part could be how other modules interact with this module… at this point I'm not sure – possibly though attaching events to content types?

7. A threaded comments module.

I would like to see a module that allows me to do something like cnet.com or stackoverflow where I can see a conversation appearing. This could be done in conjunction with a Q+A module which I know some people have been talking about.

BlogML module for Orchard 0.5 CMS now available

Sat, 18 Jun 2011 16:44:30 GMT

Codeplex site: http://orchardblogml.codeplex.com

What is BlogML?
BlogML is an open format derived from XML to store and restore the contents of a blog from one location to another.

Is BlogML open source?
Yes of course… http://blogml.codeplex.com/

The Module! -

A month after publishing the BlogML module for 0.5 I have finally got around to writing to tell you the users where and how to use it. I have used the screen shots that have been provided in emails from Bradley Millington, thanks Bradley, I owe you!

A quick tour:

1) Find the BlogML module in our gallery feed:

2) Then enable the NGM.BlogML feature on the Features admin page:

3) This exposes a new “Import” menu under “Blogs”:

4) To import a blog (and posts, tags, comments), browse for a valid BlogML XML file. You can also specify a pattern to match for identifying post URL slugs:

5) Upload and import, and you’ll get a success message for each imported blog and post:

6) Note the new Blog shows up under Manage Blogs (and my previous blog is still retained too):

7) The Import feature handles import of tags and comments too, including the approval state of each comment.

8) The Blog ML module also exposes some settings for customizing directories:

After having issues with source control all seems to have corrected itself and thanks to all who have been waiting and logged issues on the codeplex site. For all those who don’t yet know where the code is, please check http://orchardblogml.codeplex.com and download the latest version.

Thanks all, and let me know what you think.

Cheers, Nick

Why do Microsoft not put more effort in to Orchard instead of using Word press?

Sat, 18 Jun 2011 16:44:30 GMT

Today I make my rounds on the usual sites to catch up with the likes of techie news and the such and I see great news that Microsoft has decided to axe Windows Live Spaces (http://news.cnet.com/8301-13860_3-20017745-56.html?tag=topTechContentWrap;editorPicks) though I think this is a partially good idea, I cant understand there reasoning behind wanting to move to word press.

Word press granted is a very mature blogging tool, and Orchard on the other hand is very young, but If I was Microsoft I would have taken what I had learned and moved it in to Orchard, instead of moving users to a aging word press platform.

Orchard to me is a very young system and has a long way to go, but surely Microsoft should decide that this is the way to go and get more people behind this open source project.

Rant Over….

Upgrading my blog from Wordpress to Orchard 0.5

Sat, 18 Jun 2011 16:44:30 GMT

Well, I have done it!! Nick Mayne is no longer a word press member, instead I have bought in to this new CMS system called Orchard. The Orchard system however is not that new to me as I have been working with it since December of 2009.

So what exactly needed to be done in order for me to move my blog over to Orchard?

1. Download the latest Build which in this case is Orchard 0.5
2. Next create a theme directory called themayneissue underneath Orchard.Web\Themes\<ThemeNameHere>
3. Create my theme, in this instance I copied the Contoso theme and used this as a basis.
4. I then build my solution using the instruction found here: http://orchardproject.net/docs/Building-and-deploying-Orchard-from-a-source-code-drop.ashx
5. Using FileZilla I then upload to my new shiny site to my new host Discountasp.net (Don't forget to repoint your domain if you have one)
6. Next thing to do is fire up the site, My site is running on SqlCe and so far works fantastic.
7. Head to your Admin Area and select your new theme.

Okay, So now my site is empty but looking quite sexy… next is to create my blog…. wait I already have a blog don’t I? Okay so time to get that blog and move it across.. I decided to use a BlogML module that I have written and published to the Orchard Gallery Feed so anyone can use it.

Getting my blog out of wordpress was easy, but getting it in to an acceptable format was a nightmare, but i refused to write a wordpress plugin for Orchard, instead I asked my self Is there a wordpress to BlogML converter?? YES!!! found one here.. http://www.visualsoftware.net/Blog/post/2009/10/27/WordPress-eXtended-RSS-to-BlogMl-converter-WXR-2-BlogML.aspx So lets continue,

8. Export your wordpress blog out in to a xml format.
9. Fire up WXR2BlogML and you will end up with a file with the same name except you have *_BlogML attached to the end.

So now I have my blog in a BlogML format, lets import it.

Note: If you haven't already installed the NGM.BlogML module please do that before continuing

10. Open up the admin area and click ‘import’ under the Blogs Section. (Remember: that all details of your blog can be changed later, the main this in that you get your data in!) Choose your blog and click upload.
11. Hey presto.. after modifying some setting on my blog – mainly a rename, I have my website.

Nick

Custom Home Page Provider for Static Pages in Orchard

Sat, 18 Jun 2011 16:44:30 GMT

Orchard is built with a home page provider pattern so that you can say this content item is the home page. The problem is if your homepage is something that doesn't exist as a content item.. i.e. a static page.

The problem is that there is no way to tell orchard that a custom static page is the home page, so you need to buy in to the provider model, and the ‘trick’ it. So here is how I have done it.

public class CustomHomePageProvider : IHomePageProvider {
    public CustomHomePageProvider() {
        CurrentSite.HomePage = "CustomHomePageProvider;0";
    }

    protected virtual ISite CurrentSite { get; [UsedImplicitly] private set; }

    public string GetProviderName() {
        return "CustomHomePageProvider";
    }

    public ActionResult GetHomePage(int itemId) {
        //  We ignore the itemId as this is the part that we dont want.
        return new ViewResult {
            ViewName = "~/Modules/Orchard.LathamImages/Views/Test/Index.ascx",
            ViewData = new ViewDataDictionary<IndexViewModel>(new IndexViewModel())
        };
    }
}

First you need to create a class that implements the IHomePageProvider.

You can then make the assignment of the home page provider by always reassigning it in your ctor. (Yes I know I'm calling a virtual method in a ctor)

Next, set the view name in the GetHomePage method passing in any know ViewModel etc.

That's It… now every time you start your site up, you will be using this home page.

The problem is that you can now never change the homepage… Well, food for thought I guess..

Custom Redirect Results in Asp.Net MVC

Sat, 18 Jun 2011 16:44:30 GMT

So after writing lots of code with return new redirect(“”) or RedirectToRoute etc, I decided i had had enough, and thought it would be a little nicer to have something return that made sense and could be reused, instead of stings for locations all over the place making my code look nasty.

So here is the the problem code that has lots of things that look like this…

return Redirect("/paymentoffline");

So instead of having this code smell, why not replace it with a class, somewhere we only have to specify the url once?

public class PaymentOfflineResult : RedirectResult {
    public PaymentOfflineResult()
        : base("/paymentoffline") {
    }
}

And now all we have to do is….

return new PaymentOfflineResult();

Is that not a lot cleaner??

AttachUpdated command for Entity Framework

Sat, 18 Jun 2011 16:44:30 GMT

So who here has tried to get an entity that is disconnected reattached with all relevant references updated? I know i have… And after scouting the web for solution after solution here are the set of methods that works for me… They are a mismatch better a lot of other people methods, but this seems to be the best combination and so far I have had no problems.

Note : That my entitykeys are usually ‘Id’ so if your are different, then you will need to slightly change the code i.e. where is says ‘Id’

public static class EntityFrameworkExtensionMethods {

    public static void AttachUpdated(this ObjectContext ctx, EntityObject objectDetached) {
        if (objectDetached.EntityKey == null) {
            String entitySetName = GetEntitySetFullName(ctx, objectDetached);
            int objectId = (int)objectDetached.GetType().GetProperty("Id").GetValue(objectDetached, null);
            objectDetached.EntityKey = new System.Data.EntityKey(entitySetName, "Id", objectId);
        }
        if (objectDetached.EntityState == EntityState.Detached || objectDetached.EntityState == EntityState.Modified) {
            object currentEntityInDb = null;
            if (ctx.TryGetObjectByKey(objectDetached.EntityKey, out currentEntityInDb)) {
                ctx.ApplyPropertyChanges(objectDetached.EntityKey.EntitySetName, objectDetached);
                ctx.ApplyReferencePropertyChanges((IEntityWithRelationships)objectDetached,
                                                  (IEntityWithRelationships)currentEntityInDb);  //extension
            }
            else {
                throw new ObjectNotFoundException();
            }
        }
    }

    public static string GetEntitySetFullName(this ObjectContext context, EntityObject entity) {
        // If the EntityKey exists, simply get the Entity Set name from the key
        if (entity.EntityKey != null) {
            return entity.EntityKey.EntitySetName;
        }
        else {
            string entityTypeName = entity.GetType().Name;
            var container = context.MetadataWorkspace.GetEntityContainer(context.DefaultContainerName, DataSpace.CSpace);
            string entitySetName = (from meta in container.BaseEntitySets
                                    where meta.ElementType.Name == entityTypeName
                                    select meta.Name).First();

            return container.Name + "." + entitySetName;
        }
    }

    public static void ApplyReferencePropertyChanges(this ObjectContext ctx, IEntityWithRelationships newEntity, IEntityWithRelationships oldEntity) {
        foreach (var relatedEnd in oldEntity.RelationshipManager.GetAllRelatedEnds()) {
            var oldRef = relatedEnd as EntityReference;
            if (oldRef != null) {
                var newRef =
                    newEntity.RelationshipManager.GetRelatedEnd(oldRef.RelationshipName, oldRef.TargetRoleName) as
                    EntityReference;

                if (newRef != null && newRef.EntityKey == null) {
                    PropertyInfo info = newRef.GetType().GetProperty("Value",
                                                                     BindingFlags.Public | BindingFlags.Instance);
                    object val = info.GetValue(newRef, null);
                    if (val != null) {
                        string entitySetName = string.Empty;
                        var objVal = val as EntityObject;
                        if (objVal != null)
                            entitySetName = GetEntitySetFullName(ctx, objVal);

                        newRef.EntityKey = ctx.CreateEntityKey(entitySetName, val);
                    }
                    else if (oldRef.EntityKey != null) {
                        oldRef.EntityKey = null;
                    }
                }

                oldRef.EntityKey = newRef.EntityKey;
            }
        }
    }
}

You can use this by doing so… Where Student is your EntityObject

public int Save(Student student) {
    using (var context = new sitsEntities()) {
        if ((student.Code != null) && (student.EntityState == EntityState.Detached 
            || student.EntityState == EntityState.Modified))
            context.AttachUpdated(student);
        else if (student.Code == null) {
            context.AddObject(context.GetEntitySetFullName(student), student);
        }

        return context.SaveChanges(true);
    }
}

Any issues let me know, as I use this code in live environments!!!

Making menus in Orchard a little better

Sat, 18 Jun 2011 16:44:30 GMT

After keeping an eye on the Orchard forums and then doing some work on a clients website that has been implemented in Orchard, I soon became one of those people needing a decent menu. So, I thought to myself, well what does orchard have that I can use, after all - I don’t really want to have to do a lot of work just for a menu.

Note : This is all based around the last iteration of Orchard within Visual Studio 2008 framework 3.5.

So what does Orchard have that I can use…

1. Admin page for Menu
2. Allows you to store menu positions as 1 1.1 1.1.1 2 2.2 etc…
3. You can override the menu within your theme

Okay, so I got to thinking, if I can store the positions broken down like this, why cant i retrieve them like this, and go on to build the necessary menu steps? Well I can… here is how..

Step 1: In your theme, create a Menu.ascx file.

And drop this code in to it. (this is a modified version of the one located in Orchard.Themes)

<%@ Control Language="C#" Inherits="Orchard.Mvc.ViewUserControl<Orchard.Mvc.ViewModels.BaseViewModel>" %>
<%@ Import Namespace="Orchard.Utility.Extensions"%><%
    var menu = Model.Menu.FirstOrDefault();
    if (menu != null && menu.Items.Count() > 0) { %>
    <ul class="menu" role="navigation"><%
        int counter = 0, count = menu.Items.Count() - 1;
        int previousLevel = 1;
        int currentLevel = 1;
        foreach (var menuItem in menu.Items.OrderBy(m => m.Position)) {
            var sbClass = new StringBuilder(10);
            if (counter == 0)
                sbClass.Append("first ");
            if (counter == count) {
                sbClass.Append("last ");
            }
            if (string.Equals(menuItem.Href, Request.ToUrlString(), StringComparison.InvariantCultureIgnoreCase))
                sbClass.Append("current ");

            currentLevel = menuItem.Position.Split('.').Length;
            if ((previousLevel == currentLevel) && counter >= 1){ %>
                </li>
            <%}
            if (previousLevel < currentLevel) {
                sbClass.Append("first ");%>
                <ul>
            <% }
            if (previousLevel > currentLevel) {
                for (int i = 0; i < (previousLevel - currentLevel); i++) { %>
                </li> </ul>
            <% } %> </li> <%}
            var classValue = sbClass.ToString().TrimEnd();
            var linkAttributes = new Dictionary<string, object>();
            if (!string.IsNullOrEmpty(menuItem.AccessKey))
                linkAttributes.Add("accesskey", menuItem.AccessKey);
            %>
                <li<%=!string.IsNullOrEmpty(classValue) ? string.Format(" class=\"{0}\"", classValue) : "" %>><%=Html.Link(menuItem.Text, menuItem.Href, linkAttributes)%>
                
            <% previousLevel = currentLevel;
               if (counter == count) { %>
                </li>
            <% for (int i = 1; i < previousLevel; i++) { %>
                </ul> </li>
            <% } }

            ++counter;
        } %>
    </ul>
<% } %>

Next head to your manage menu section in the admin screens…. usually http://localhost:30320/Admin/Navigation

Set up your positions like below… Click Update All

Next head back to your front page, and you should start seeing html like so....

<div class="menucontainer">
    <ul class="menu" id="nav-one">
        <li class="first"><a href="/">Home</a></li>
        <li><a href="/Test/Gallery">Portfolio</a>      
            <ul class="nested">
                <li class="last"><a href="/Test/Gallery/Item/University Work">University Work</a></li>
            </ul>
        </li>
    </ul>
</div>

I admit, I have done this in a little bit of a rush, so there could be one or two bugs creeping around.

Okay once this is done… So can then apply Suckerfish or what ever over the top… i used http://be.twixt.us/jquery/suckerFish.php which is the jquery equivalent.

Happy Orchard Picking everyone.

Note : Fixed issue with it not showing the ‘First’ class correctly. 29/July/2010

Note : Fixed issue with missing closing </li>. 04/Aug/2010

Nick

Twitter Tweet Tweet Just Joined

Sat, 18 Jun 2011 16:44:30 GMT

Hey all… I have just joined Twitter!!.. if you wish to follow…

http://twitter.com/NicholasMayne

See you there! :)

Orchard CMS - Simple Profile Package

Sat, 18 Jun 2011 16:44:30 GMT

I started to do some work on profiles for a site we were building at work, and then we decided to jump ship on to Orchard. While Profiles haven't really been asked for as a requirement at work, i noticed the Orchard team have it on there back log, and as i wanted it and I'm a developer, why wait… why not just write one!.

This solution have is very basic Profiling -

Forename, Middle name, Surname
Date Of Birth
Age – Derived from DOB
Gender
Occupation
Image Name – There is a setting to tell the url builder where to get your image from.
Website address
IsPrivate mode
Edit and View Mode + Anom viewing
Simple Profile Permissions attached to roles.

To install it

Unzip The Orchard.Profiles Package to under the \Orchard.Web\Packages\Orchard.Profiles
Open the Orchard.sln solution
Right Click on Packages and Add existing Items Browse to and select \Orchard.Web\Packages\Orchard.Profiles\Orchard.Profile.csproj and Add
Right click on the Orchard.Web solutions References and Add a project reference to Orchard.Profiles to which you have just added.
Hit F5 And it should be plugged in, compiled and ready for use.

Once you Register a user, you should be able to then go to http://localhost:30320/Profile/<UserName>

If you have any problems getting it working leave a comment and i would be happy to help.

Here is a couple screenshots of it working…

Viewing a Profile.. Note the Url in the address bar.

The Edit button that appears on the right, will only appear if you have permission to edit your profile. This can be set in the Permissions section in Orchard.

If the profile has be set to private, then the page will redirect to a ProfilePrivateResult ONLY if you are attempting to view a profile other than your own.

Editing a Profile is a little different, as i haven't plugged in all the pretty moving things.

Just so you are aware, the Roles section down the bottom is only shown if a user can modify their roles, this is coming from Orchard.Roles.

The Image Name will be the image i.e. AnImage.png, A Url helper will then fully qualify this based on a setting called Image Folder, which can be modified in the Orchard Settings Section.

Note the setting down the bottom.

So if you add an image to Media/Profiles/Images

Then you add that name to the ImageName field on the Profile Edit page then you should see something that looks like this…

Hit Save… And Hey Presto!! You have an image… granted, mine is a bit squashed!

Anyways here is the code for download.

Download Code (C#) -

Orchard.Profiles - 46160.zip

This will be an ongoing piece of work, but i will update this page, and add pages for more advanced features in the future.

Let me know how you get on, and please feed back any Constructive criticism you have, as it will only make my work better for me to upload to you lot.

This code was written in C# against Orchard Change set 46160.

Off Travelling – Take 2

Sat, 18 Jun 2011 16:44:30 GMT

Well i have handed my notice in at work to embark on a new travelling experience with Penny… Here is the planned itinerary…

1. Fly to Boston… Spend a couple nights there

2. Next onwards to Maine… I really want to give Ice Diving a go.. Sounds Cold huh.

3. Pen wants to go to Niagara Falls, so i think we will go there

4. After that Me and Pen are headed to my cousins Wedding Reception in Newtown, PA which should be awesome, and cheap!! – Hopefully Kathy will do my laundry

5. A couple days after that we fly to Lima in Peru and embark on the Inca Trail

6. I would then like to do a Jungle Lodge overlooking the Amazon rainforest.

7. After travelling around Peru for a while, and hitting one or two beaches, Pens idea! We are heading up to Ecuador

8. Scuba Scuba around the Galapagos islands here i come!

9. Fly home and look for a place to live and a job! – Microsoft Hire Me!

10. The End! – Photos on my facebook! http://www.facebook.com/nick.mayne?ref=name

Complete Regular Expression for URL’s

Sat, 18 Jun 2011 16:44:30 GMT

Today i was looking for a IsUrl(string) method to verify if a string is a URL or not and stumbled across this regex…. http://internet.ls-la.net/folklore/url-regexpr.html - make sure you have your hard hats on for this one!… Its the complete regex for a URL.

Nick Out!