Rank: Member
Joined: 1/17/2011(UTC) Posts: 10 Location: NH
|
Is there documentation available for writing DLL plugins? I found the docs for creating parsing rules in CustomTitle but I want to explore ways to collect document info from an app that does not put that in its title bar.
Can we write our own DLL plugins?
Thanks, Tom
|
|
|
|
Rank: Administration
Joined: 4/13/2010(UTC) Posts: 872
|
There is a sample project located here: http://cdn.manictime.com...anicTimePluginTester.zipIt contains sample plugins for notepad, outlook and zplayer.
|
|
|
|
Rank: Advanced Member
Joined: 6/24/2011(UTC) Posts: 147 Location: New York, NY
|
I notice that the DocumentInfo object keeps separate values for DocumentDisplayName and DocumentGroupName. In the plugin for OneNote you happen to have set them both to the same value. How are each of these values used in the UI? In terms of their use, what disinguishes them?
I'm assuming that DocumentGroupName is the one exposed in the aggregation pane of the Day view. I'm guessing this because when I apply a filter from one of those values in the aggregation area, the filter says "group=<>". Where, then, is DocumentDisplayName used?
If I happen to rename "all instance of <>" from the Document timeline, which value is being modified, the DisplayName or the GroupName (as stored in the database)? Would there be any be any way to connect that back to new captures by the plugin (if it still captures by the old values)?
|
|
|
|
Rank: Administration
Joined: 4/13/2010(UTC) Posts: 872
|
You can think of DocumentGroupName as the group key by which ManicTime identifies a group. DocumentDisplayName is the one displayed in the summary pane. Plugins usually assign the same value to both properties.
When you rename a group, it renames DocumentDisplayName. DocumentGroupName cannot be changed. If a plugin captures the same group (identified by DocumentGroupName) with old name (before rename), the renamed value is used (DocumentDisplayName captured by the plugin is ignored).
I hope this helps.
|
|
|
|
Rank: Advanced Member
Joined: 6/24/2011(UTC) Posts: 147 Location: New York, NY
|
It does, thanks.
One wrinkle:
if the DocumentGroupDisplayName is changed via the plugin (rather than the UI), but keeps the DocumentGroupName the same, which DisplayName takes precendence in the UI? The earlier values captured, or the new?
|
|
|
|
Rank: Administration
Joined: 4/13/2010(UTC) Posts: 872
|
The earlier value is always used. Display name is only used for the first time, when a group with a new key is detected and created in the database. When plugin reports a new display name for existing group, it is ignored.
|
|
|
|
Forum Jump
You cannot post new topics in this forum.
You cannot reply to topics in this forum.
You cannot delete your posts in this forum.
You cannot edit your posts in this forum.
You cannot create polls in this forum.
You cannot vote in polls in this forum.