Soma

Admin Hot Keys

Recommended Posts

ProcessWire2.+ Admin Hot Keys 0.0.7

This modules adds hot keys functionality to PW backend. The keys can be configured in the module settings in the admin.

I created a repo here for download and if anyone interested in picking it up.

https://github.com/s...ic/AdminHotKeys

Currently it supports

  • Save : ctrl+s
  • Add New : ctrl+n
  • View Page : ctrl+v
  • Open Pages search : alt+q (search field can be configured)
  • Open Templates search : ctrl+shift+t
  • Open Fields search : ctrl+shift+f
  • Goto Pages : ctrl+shift+p
  • Goto Setup : ctrl+shift+s
  • Goto Modules : ctrl+shift+m
  • Goto Access : ctrl+shift+a

Note: If you're inside a text input it will ignore the hot keys, as to avoid problems with already defined key.

Tip: If you open up templates or fields autocomplete search `ctrl+shift+f|t` press `shift+tab` to focus on the link in the label previous to the search input box. Now hit enter to get right to the template or field screen. (If using FF make sure to enable tab focus for all elements in MacOSX: http://support.mozil...enus or buttons)

  • Like 14

Share this post


Link to post
Share on other sites

Your welcome. Thanks.

Little update after playing around a little.

  • changed to use save hot key for all edit screens to save not only page.
  • added "Add new" hot key support for Template, Fields, Users, anything that has a "Add new" button.

Have fun.

  • Like 1

Share this post


Link to post
Share on other sites

Hi Philipp,

Chrome on OS X likes it but I get some strange things happening in Firefox (13). I can't collapse any fields or use the PageListSelect.

Regards

Marty

Share this post


Link to post
Share on other sites

Thanks Marty, just commited an update that should fix it for FF.

Share this post


Link to post
Share on other sites

Added several new actions.

Added shortcuts to admin main pages.

The most fun is to open a autcomplete search to find and edit templates or fields. Now you can wherever you are press "ctrl+shift+t" or "ctrl+shift+f" and get something like this:

post-100-0-78689000-1342606119_thumb.png

Once open you can type and select, hit enter and directly go to edit screen.

Enter a char and hit backspace to show all.

Have fun.

Share this post


Link to post
Share on other sites

Wow, this is a nice little helper. Great work!

One suggestion. Is it possible to go to the templates / field main page if I just press enter in the empty modal? This way we dont't need a additonal shortcut for these pages.

  • Like 1

Share this post


Link to post
Share on other sites

Thanks all!

Little update for 0.0.6

- added View Page to the list "ctrl+v".

- Also, I was thinking about adding a shortcut to the Template and Field pages.

I figured simplest is to add a link in the label in front of the searchfield. If you open the dialog, you can now simply press "shift+tab" to focus on that link and hit enter.

Edit: lol, just figured that "shift+tab" doesn't seem to work in FF. Back to the drawingboard :D¨

Edit2: Ok this seem related to OS setting in MacOSX. If in FF make sure this in enabled http://support.mozil...enus or buttons

Share this post


Link to post
Share on other sites

I think this"little module" adds a way quicker workflow to ProcessWire, maybe it's a good thing to make it core module.

Share this post


Link to post
Share on other sites

Soma - CTRL+V is paste on a windows PC so not sure whether there are any issues there? Just a thought.

Share this post


Link to post
Share on other sites

Soma - CTRL+V is paste on a windows PC so not sure whether there are any issues there? Just a thought.

Yeah I know, you can change it in the settings. I also thought the same but couldn't decide what would be best.

Share this post


Link to post
Share on other sites

I don't know whether you could work around it by checking if an input field or textures is selected before deciding on the action? If a field is selected it would make sense to leave it as paste, else view page in a new window maybe.

Share this post


Link to post
Share on other sites

Thanks Pete. But that's not really a solution I like :D

Share this post


Link to post
Share on other sites

Ok lol funny, it seems the hotkey jquery plugin already is ignoring commands if inside text inputs! So this already is solved this way. I thought it would be unnecessary to implement and I'm not sure it really is the best solution, but will help avoid problems in first place (as it also stated in Resigs plugin) . It would be nice to not needing to leave input focus to be able to save or do other actions while typing. But guess not really an issue.

Share this post


Link to post
Share on other sites

Soma, you have swapped the labels of "Goto Setup" and "Goto Pages" in AdminHotkeys.module

Your module is now part of my default processwire setup. Really useful..

Share this post


Link to post
Share on other sites

Thanks, nice catch. It's corrected in the latest commit.

Share this post


Link to post
Share on other sites

Hello, just commited a new update.

  • Added new action to search for Pages using PW internal ajax search "alt+q". You can even select template to filter.
  • Added setting to change the fields used in page search. Default "title body". Search uses %= (SQL like)
  • Changed dialogs to position fixed so they appear right where you are and page doesn't jump
  • Added check so it doesn't get initialized on login screen

post-100-0-94410900-1342744540_thumb.png

post-100-0-59933800-1342744546_thumb.png

  • Like 1

Share this post


Link to post
Share on other sites

Great update Soma! I'm really liking the new ajax page search. Only thing I wanted to mention though was the default key assigned to this ALT+Q can't be assigned in OS X because it's the application Quit command. I did it, and it immediately quit the browser, closed all windows, etc. I changed it to CTRL+Q, which seems to work well, but am thinking you chose alt+q because ctrl+q has the same problem on windows? Maybe there is some other default for this that would be safe across platforms? Maybe something like CTRL+. or CTRL+[ or CTRL+-

I love everything about this module, except that I'm confused by the templates/fields search. Probably because I'm just accustomed to clicking, rather than typing template/field names in the admin. In most sites, the quantities here are small enough to make the search seem overkill. So if there were a most wished for feature on my part, it would be that either: 1) it showed a list of templates/fields rather than a search box. Or; 2) that the field/template search boxes showed all of the fields/templates (that you could click to edit) and then filtered (rather than created) in the list as you type.

  • Like 1

Share this post


Link to post
Share on other sites

Oddly in Windows it's Alt+F4 to quit an application, so Alt+Q probably starts your car by that logic ;)

Not saying Macs make any more sense mind, requiring a key with a fruit on when they ran out of letters and numbers that by all rights should produce an apple when pressed. :P

Share this post


Link to post
Share on other sites

Thanks Ryan for the suggestions. I'm not sure what u mean by this is quit application. On my mac command q is quit alt q is a special char. I sent you from my phone so keeping it short.

Share this post


Link to post
Share on other sites

I'm actually using a 1987 IBM Model-M keyboard with my Mac, so I have an ALT key rather than an Command (Apple) key. But unless I'm mistaken, ALT and Command (Apple) are just platform specific names for the same thing. Macs also have something called the Option key, which I don't think has an equivalent on the PC. In my case, I just have Option mapped to my caps-lock key since I'm using an elderly PC keyboard. Regardless, I think that anyone on a Mac that uses this module would find the default search command (ALT-Q) causes their browser to quit. :) Though given that my setup isn't conventional Mac, it might be good for someone else on OS X to confirm.

Share this post


Link to post
Share on other sites

The Alt key (also called the Option key) on Macs is normally used for special characters and adding umlauts and accents on letters. The default command for quit is CMD + Q. For me, the Alt + Q is not used for anything important (well it creates this nice character - œ )

Great module soma - very useful.

Did you think of a way around the issue with it not working when the field is in focus? I’d really like to be able to edit a field and then Ctrl + S to save - at present there is no way to quickly get out of the field so the shortcuts will work, without using the mouse. Maybe if you could press escape to exit the field and then use the shortcut? Or could you bind the plugin to all input fields? I am guessing you might also have some issues with Tinymce which has its own keyboard shortcuts. Probably not a simple solution to this one.

I like the search overlays, it’s like a quick launcher - pressing Escape to close the overlay dialog would be useful.

If you are looking for inspiration for more shortcuts I always thought the Gmail ones were very good

http://support.google.com/mail/bin/answer.py?hl=en&answer=6594

A way to navigate the tree would be great (although the “quick launcher” way is probably much better). Or a way to open next and previous items in the tree.

And a help overlay mapped to ? which shows current shortcuts would be useful during the Shortcut learning phase (and for clients)

Share this post


Link to post
Share on other sites

Create an account or sign in to comment

You need to be a member in order to leave a comment

Create an account

Sign up for a new account in our community. It's easy!

Register a new account

Sign in

Already have an account? Sign in here.

Sign In Now

  • Recently Browsing   0 members

    No registered users viewing this page.

  • Similar Content

    • By Soma
      LogMaintenance
      A simple ProcessWire module to give some maintenance control over log files. I found myself often having lots of log files for different things that can grow more or less quickly to a size where they can be difficult to maintain. The built in Logger of PW does a good job of giving you the possibility to delete or prune logs. But it has to be done manually and sometimes a log grows into millions of lines, which makes it often impossible to even prune it as it's too large.
      LogMaintenance uses LazyCron to run the maintenance task and there's several settings you can setup on a global or per log basis.
      Archive: will create zip files for each log file in logs/archive/ folder and add the log each time the maintenance is run to a subfolder containing the datetime.
      Lines: keeps logs to a certain number of lines 
      Days: keeps the log to a certain number of days
      Bytes: keeps the log to a certain amount of bytes
      Each setting is checked from top down, the first setting to contain something is used. So if you check the "Archive" option, all other settings are ignored and logs are archived everytime the LazyCron is executed. If you want to keep your logs to a certain amount of bytes just leave all other settings to 0 or blank.
      Per Log Settings
      There's a textarea that you can use to setup a config for a specific log file one per line. All the logs you define here ignore the global settings above. The syntax for the settings is:
      logname:[archive]:[lines]:[days]:[bytes] 
      errors:1:0:0:0 // would archive the errors log messages:0:10000:0:0 // will prune the errors log to 10000 lines  
      The module can be found on github for you to check out. It's still fresh and I'm currently testing.
      https://github.com/somatonic/LogMaintenance
    • By teppo
      Fieldtype Page IDs is a third party Fieldtype that, simply put, stores Page references as integers (Page IDs).
      This fieldtype was built as a quick and dirty workaround for Page Reference fields' inability handle self-references due to circular reference issues. A project I've been working on for a while now includes a combination of RepeaterMatrix content blocks and tagging/categorization system that would've resulted in a lot of duplicate pages (and plenty of unnecessary manual work for content editors) had I used built-in Page Reference fields, and thus a new Fieldtype felt like the most sensible approach.
      Fieldtype Page IDs was designed to be loosely compatible with Page References in order to make conversions between the two feasible, but it is quite limited feature wise:
      largely due to the fact that stored values are actually just integers with no connection to Pages whatsoever some advanced selectors and related features are not supported, and page values can't be directly accessed configuration settings are limited to the bare essentials (selector string and Inputfield class) only a handful of Inputfields (AsmSelect, Checkboxes, Text) are (currently) supported Anyway, in case you need to store Page IDs (and Page IDs only) and are happy with the limitations mentioned above, feel free to give this Fieldtype a try. It has been working fine for me in one particular project, but hasn't been tested that much, so please tread carefully – and let me know if you run into any issues.
      GitHub repository: https://github.com/teppokoivula/FieldtypePageIDs
      Modules directory: https://modules.processwire.com/modules/fieldtype-page-ids/
    • By daniels
      This is a lightweight alternative to other newsletter & newsletter-subscription modules.
      You can find the Module in the Modules directory and on Github
      It can subscribe, update, unsubscribe & delete a user in a list in Mailchimp with MailChimp API 3.0. It does not provide any forms or validation, so you can feel free to use your own. To protect your users, it does not save any user data in logs or sends them to an admin.
      This module fits your needs if you...
      ...use Mailchimp as your newsletter / email-automation tool ...want to let users subscribe to your newsletter on your website ...want to use your own form, validation and messages (with or without the wire forms) ...don't want any personal user data saved in any way in your ProcessWire environment (cf. EU data regulation terms) ...like to subscribe, update, unsubscribe or delete users to/from different lists ...like the Mailchimp UI for creating / sending / reviewing email campaigns *I have only tested it with PHP 7.x so far, so use on owners risk
      EDIT:
      I've updated the module to 0.0.4. I removed the instructions from this forum, so I don't have to maintain it on multiple places. Just checkout the readme on github 🙂
      If you have questions or like to contribute, just post a reply or create an issue or pr on github. 
    • By bernhard
      WHY?
      This module was built to fill the gap between simple $pages->find() operations and complex SQL queries.
      The problem with $pages->find() is that it loads all pages into memory and that can be a problem when querying multiple thousands of pages. Even $pages->findMany() loads all pages into memory and therefore is a lot slower than regular SQL.
      The problem with SQL on the other hand is, that the queries are quite complex to build. All fields are separate tables, some repeatable fields use multiple rows for their content that belong to only one single page, you always need to check for the page status (which is not necessary on regular find() operations and therefore nobody is used to that).
      In short: It is far too much work to efficiently and easily get an array of data based on PW pages and fields and I need that a lot for my RockGrid module to build all kinds of tabular data.

      Basic Usage

       
      Docs & Download
      https://modules.processwire.com/modules/rock-finder/
      https://gitlab.com/baumrock/RockFinder/tree/master
       
      Changelog
      180528, v1.0.4 add custom select statement option 180516 change sql query method, bump version to 1.0.0 180515 multilang bugfix 180513 beta release <180513 preview/discussion took place here: https://processwire.com/talk/topic/18983-rocksqlfinder-highly-efficient-and-flexible-sql-finder-module/
    • By blynx
      Hej,
      A module which helps including Photoswipe and brings some modules for rendering gallery markup. Feedback highly appreciated
      (Also pull requests are appreciated 😉 - have a new Job now and don't work a lot with ProcessWire anymore, yet, feel free to contact me here or on GitHub, Im'm still "online"!)

      Modules directory: http://modules.processwire.com/modules/markup-processwire-photoswipe
      .zip download: https://github.com/blynx/MarkupProcesswirePhotoswipe/archive/master.zip
      You can add a photoswipe enabled thumbnail gallery / lightbox to your site like this. Just pass an image field to the renderGallery method:
      <?php $pwpswp = $modules->get('Pwpswp'); echo $pwpswp->renderGallery($page->nicePictures); Options are provided like so:
      <?php $galleryOptions = [ 'imageResizerOptions' => [ 'size' => '500x500' 'quality' => 70, 'upscaling' => false, 'cropping' => false ], 'loresResizerOptions' => [ 'size' => '500x500' 'quality' => 20, 'upscaling' => false, 'cropping' => false ], 'pswpOptions' => (object) [ 'shareEl' => false, 'indexIndicatorSep' => ' von ', 'closeOnScroll' => false ] ]; echo $pswp->renderGallery($page->images, $galleryOptions); More info about all that is in the readme: https://github.com/blynx/MarkupProcesswirePhotoswipe
      What do you think? Any ideas, bugs, critique, requests?
      cheers
      Steffen