1) How do I get the entry into attachment_fs_root_folder_map that seems to be needed by attachments to find its storage? Is there a UI trick, a manual step, a required site map configuration or what?
Attachments configuration is manual at this point. The steps would be:
1) instantiate (or pick an existing instance of) file storage
2) determine the root_folder_id of the instance
3) determine the package_id for the package you'd like attachments enabled for
4) manually insert the row:
insert into attachment_fs_root_folder_map
(folder_id, package_id)
values
(:an_fs_root_folder_id, :package_id_for_which_you_want_attachments);
2) A link to the (singleton) instance of Attachments must be present under every forum instance that wants to use attachments; and that link must be named "attach". Is that right?
Yes.
3) A link to some instance of File Storage must be mounted under every forum instance (as a sibling to attach) that wants to use attachments. That URL may have any name. Is that right?
You can map any fs root folder to any attachments package. All instances of attachments on your system can use the same file storage instance if you like.
4) Is there any documentation on the correct way to configure/use Attachments?
Umm... I guess there is now ;)
Seriously, though - this info came from a brief chat with with Arjun Sanyal (who wrote the attachments package) a couple of months ago. Hopefully he'll correct me if anything I said is incorrect.
I don't know if there are any plans to create a UI for this configuration step but package developers could take care of this configuration work in thier _post_instantiation package init procs.
