Nibble

Archive for January, 2009

Getting started with umbraco v4 2

Yesterday umbraco 4 was released, this post is an updated version of the getting started with umbraco one I did some time ago.

What is umbraco screencast

Download:

You can always find the latest umbraco release on codeplex

http://www.codeplex.com/umbraco/Release/ProjectReleases.aspx

Installation:

Install umbraco 4 on Windows Vista
Install umbraco 4 on “localhost” - simplified
Screencast 1
Screencast 2 (installation in 200 seconds)

Basics:

Document types:

Umbraco basics: document types by umbraco founder Niels Hartvig - part 1, part 2
Document Types Explained
Screencast

New feature in v4, master document types

Templates:

Screencasts on v4 masterpages by Warren Buckley - part 1, part 2, part 3

Xslt and Macro’s:

XSLT Basics
Inline xslt (new in v4)
Macro Parameters syntax

Canvas:

Introduction to Canvas

Beyond the Basics:

.Net controls and umbraco:

Screencast 1
Screencast 2

Event model:

Attaching document eventhandlers
Using ApplicationBase to register events

Base:

Introduction to /Base

Xslt extension:

Create xslt exstension like umbraco.Library

Custom datatypes:

Creating custom datatypes using the umbraco usercontrol wrapper
Creating custom umbraco datatypes

Resurrecting umbdashboard part 1: Zip Upload, bulk upload files to the media section of umbraco 54

Umbdashboard which can be found on codeplex is a collection of handy umbraco dashboard controls (some info on dashboard). But it’s an old project developed for a previous version of umbraco. So I’ve started porting these to umbraco v4. First up is zip upload.

Basicly zip upload is a small dashboard control that allows you to upload a zip file to the media section of umbraco. All files in the zip get created as media items and it also respects folder structure.

Once it’s installed you can find it on the dashboard of the media section.

zipupload

So you can pick a media folder (if no folder is selected it creates a new folder based on the zip filename).

And you just need to choose the zip file and hit ‘upload zip file’.

Afterwards you’ll get a summary of the files that have been uploaded.

zipuploadfinished

If you refresh the media tree, files and folders should be in place

zipuploadmedia

Zip upload has a small configuration file (/config/zipupload.config) that looks like this:

<?xml version=”1.0″ encoding=”utf-8″ ?> 
<zipUpload>
    <fileNodeTypeId>1033</fileNodeTypeId>
    <imageNodeTypeId>1032</imageNodeTypeId>
    <folderNodeTypeId>1031</folderNodeTypeId>
    <imageFileExtensions>jpeg,jpg,gif,bmp,png,tiff,tif</imageFileExtensions>
</zipUpload>

 

It contains the id’s of the media types that will be used and the file extensions that will be considered as image.

In case it doesn’t show up on the dashboard this is the snipped that needs to be inserted in the /config/dashboard.config file:

<section>
        <areas>
          <area>media</area>
        </areas>
        <tab caption=”Zip Upload”>
          <control>/usercontrols/zipupload.ascx</control>
        </tab>
</section>

Credits to the original developer of umbdashboard (think it was Niels), I only did some small modifications.

Zip Upload Package: download

Why Umbraco rocks - Easy and fast installation 2

To continue with the why umbraco rocks posts. Umbraco starts rocking at step 1, the installation. It’s just a matter of minutes to complete the easy and fast installation process.

To showcase this I did an installation time attack: Umbraco v4 installation on vista (from download to complete installation) in 3 minutes and 20 seconds. (detailed installation instructions on umbraco.org).

View the evidence here:

timeattack