1. $folder_id = $modx->documentIdentifier; -- это и будет номер текущей папки, если, конечно, это требуется.
2. если есть затруднения при определении ID при администрировании, то он, обычно, выводится в дереве документов справа от ссылок.
3. папка лишь тем отличается от обыкновенного документа, что у неё есть дети, да и соответствующее поле isfolder = 1 в таблице {prefix}_site_content