benjypng / logseq-todoist-plugin

MIT License
125 stars 19 forks source link

:gift_heart: Sponsor this project on Github or :coffee: Get me a coffee if you like this plugin!

This plugin is currently not receiving PRs.

2023-09-04: This plugin has just been refactored with breaking changes. Versioning for releases has been revamped in favour of sematic-release. Todoist Sync has been removed due to feature instability. A new set of videos for the README will be added at a later date.

Overview

This simple plugin has 2 primary features:

Retrieving tasks from Todoist.

You can retrieve tasks in 3 ways:

Sending tasks to Todoist

You can send tasks in 2 ways:

Preferences

The plugin settings page contains other preferences to customise how you want tasks to be retrieved or sent to Todoist.

Hiding block properties

The plugin automatically creates the following block properties: todoistid, comments, atttachments. If you wish to hide them, you can find the below flag in config.edn and make the changes:

 ;; hide specific properties for blocks
 ;; E.g. :block-hidden-properties #{:created-at :updated-at}
 :block-hidden-properties #{:todoistid :comments :attachments}

Installation

  1. Go to https://developer.todoist.com/appconsole.html and create an App. You will need to create an App (give it any name you like), and you will be able to obtain a test token. Note down the test token as this is the API Token that you will need in Step 3.

  2. Head on to the Marketplace and install the logseq-todoist-plugin.

  3. After it is installed, click on the plugin icon and indicate your preferences in the settings. Key in your API token that you obtained in Step 1 as well.

Development

First run

  1. Clone/fork the repo.
  2. Go to the Plugins page on Logseq (t p).
  3. Uninstall the plugin.
  4. Run npm run build to build the project.
  5. Click on "Load unpacked plugin" and choose the root directory (the one that contains the dist dir just created).

Changes

  1. Change the code.
  2. Run npm run build.
  3. Go to the Plugins page on Logseq (t p).
  4. Click on "Reload".
  5. Test your changes.