{"id":23456425,"url":"https://github.com/kunder-lab/cordova-plugin-kunder-android-shortcuts","last_synced_at":"2025-08-08T04:35:28.955Z","repository":{"id":93466445,"uuid":"124100462","full_name":"kunder-lab/cordova-plugin-kunder-android-shortcuts","owner":"kunder-lab","description":null,"archived":false,"fork":false,"pushed_at":"2018-03-19T15:37:17.000Z","size":43,"stargazers_count":2,"open_issues_count":1,"forks_count":2,"subscribers_count":32,"default_branch":"master","last_synced_at":"2025-04-11T09:12:28.778Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kunder-lab.png","metadata":{"files":{"readme":"README-es.md","changelog":"changelog.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-03-06T15:43:55.000Z","updated_at":"2018-10-22T02:11:21.000Z","dependencies_parsed_at":"2023-08-26T02:21:00.984Z","dependency_job_id":null,"html_url":"https://github.com/kunder-lab/cordova-plugin-kunder-android-shortcuts","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/kunder-lab/cordova-plugin-kunder-android-shortcuts","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kunder-lab%2Fcordova-plugin-kunder-android-shortcuts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kunder-lab%2Fcordova-plugin-kunder-android-shortcuts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kunder-lab%2Fcordova-plugin-kunder-android-shortcuts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kunder-lab%2Fcordova-plugin-kunder-android-shortcuts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kunder-lab","download_url":"https://codeload.github.com/kunder-lab/cordova-plugin-kunder-android-shortcuts/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kunder-lab%2Fcordova-plugin-kunder-android-shortcuts/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269365702,"owners_count":24405229,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-08T02:00:09.200Z","response_time":72,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-24T04:31:22.065Z","updated_at":"2025-08-08T04:35:28.934Z","avatar_url":"https://github.com/kunder-lab.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Cordova Android Shortcuts Plugin\n\nEste es un plugin de cordova que permite, de forma estática y dinámica, definir hasta 4 shortcuts, almacenando la acción del shortcut temporalmente para realizar alguna acción cuando se abra la aplicación base. Probado en proyectos basados en ionic 1, 2 y 3.\n\n## Instalación del plugin\n\nPara instalar este plugin se deberá hacer con el siguiente comando:\n\n````\ncordova plugin add https://github.com/kunder-lab/cordova-plugin-kunder-android-shortcuts.git\n````\n\n## Configuración de Shortcuts estáticos\n\nEn la raíz del proyecto base, se deberá crear la siguiente distribución de archivos:\n\n````\nandroid-shortcuts\n├─── icons\n    └─── icon_1.png //Sólo se pueden utilizar letras, números y guíones bajo para los nombres de los íconos\n    └─── icon_2.png //Estos íconos se copiarán directamente a la carpeta drawable de Android\n    ...\n    └─── icon_N.png\n└─── shortcuts.json\n````\n\nEn el archivo shortcuts.json, se deberán definir las configuraciones de los shortcuts de la siguiente forma (máximo 4 shortcuts. Si se define más de 4, éstos serán ignorados):\n\n````\n{\n    \"shortcuts\": [\n        {\n            \"shortcutId\": \"ID_1\",\n            \"icon\": \"icon_1\", // Nombre del ícono de la carpeta android-shortcuts/icons sin la extrensión\n            \"shortcutShortLabel\": \"Label Corto 1\",\n            \"shortcutLongLabel\": \"Label Largo 1\",\n            \"shortcutDisabledLabel\": \"Mensaje cuando el shortcut no esté disponible 1\",\n            \"action\": \"ACCION_1\"\n        },\n        ...\n        {\n            \"shortcutId\": \"ID_4\",\n            \"icon\": \"icon_4\",\n            \"shortcutShortLabel\": \"Label Corto 4\",\n            \"shortcutLongLabel\": \"Label Largo 4\",\n            \"shortcutDisabledLabel\": \"Mensaje cuando el shortcut no esté disponible 4\",\n            \"action\": \"ACCION_4\"\n        }\n    ]\n}\n````\n\nPara mejorar el rendimiento en el proceso de lanzamiendo de la actividad principal, se debe configurar lo siguiente en el archivo config.xml del proyecto:\n\n````\n...\n\u003cplatform name=\"android\"\u003e\n    \u003cpreference name=\"AndroidLaunchMode\" value=\"singleInstance\" /\u003e\n    ...\n````\n\n## Shortcuts dinámicos\n\n### Crear shortcut dinámico\n\nEste plugin, además, provee de un método para crear shortcuts dinámicamente (en tiempo de ejecución). Para ello, se deberá utilizar el siguiente código:\n\n````\nAndroidShortcutsPlugin.createDynamicShortcut(\n    {\n        id: 'someID',\n        action: 'someAction',\n        shortLabel: 'ShortLabel', //String que se muestra en el home de android al hacer un long press sobre la aplicación.\n        longLabel: 'LongLabel', //String que se muestra en el cajón de aplicaciones al hacer un long press sobre la aplicación.\n        icon: 'BASE64_String_icon', //String en base64 o nombre del ícono de la carpeta drawable de Android (sin extensión).\n        iconIsBase64: 'true' // (opcional) Booleano que indica si el ícono está en formato base64.\n    },\n    successCallback,\n    errorCallback\n);\n````\n\n### Eliminar todos los shortcuts dinámicos\n\nEs posible eliminar todos los shortcuts dinámicos que se hayan creado con el siguiente código (no se elimiman los shortcuts estáticos):\n\n````\nAndroidShortcutsPlugin.removeAllDynamicShortcuts(\n    successCallback,\n    errorCallback\n);\n````\n\n## Obtener Shortcut seleccionado\n\nEste plugin almacena temporalmente la acción del shortcut seleccionado por el usuario. Para obtener la acción presionada, se deberá utilizar el siguiente código:\n\n````\nAndroidShortcutsPlugin.getSelectedShortcut(function(response){\n    if(response.action === 'ACCION_1') {\n      //Do something\n    } ...\n    else if(response.action === 'ACCION_4') {\n      //Do something\n    }\n    // ignore other cases\n}, function(error) {\n    console.log(error);\n});\n````\n\nEs posible que la acción sea nula. En este caso, se debería ignorar.\nSe recomienda llamar a la función getSelectedShortcut cuando el evento \"resume\" sea llamado.\n\n## Licencia\n[GNU GENERAL PUBLIC LICENSE version 3](https://github.com/kunder-lab/cordova-plugin-kunder-android-shortcuts/blob/master/LICENSE)\n\n## Futuros features\n- Optimizar código","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkunder-lab%2Fcordova-plugin-kunder-android-shortcuts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkunder-lab%2Fcordova-plugin-kunder-android-shortcuts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkunder-lab%2Fcordova-plugin-kunder-android-shortcuts/lists"}