просто мой совет всем новичкам кто хоть немного знает английский язык - читайте английскую официальную документацию.
Очень долго пытался разобраться по разрозненным по разным сайтам рускоязычным кусочкам - очень долго и сложно.
Прочитал английскую офиц.док. - хоть мой инглиш и на низком уровне - все стало интуитивно понятно - удачи ),
да еще очень сильно помогла,
http://modxcms.com/forums/index.php/topic,30418.0.html жаль не дописана