Jump to content

ProcessBatcher


Wanze

Recommended Posts

Hi everyone!

With Batcher you can batch-edit and create Pages in the Pw Admin. If you install this module, you get a new Page "Batcher" under Setup.

Modules page: http://modules.processwire.com/modules/process-batcher/

Github: https://github.com/wanze/ProcessBatcher

post-582-0-04675500-1362135437_thumb.png post-582-0-62980800-1362135459_thumb.png

Editing

How does it work?

  1. Search your pages with a selector. You can check if you want to include also hidden/unpublished pages with the filters.
  2. Select the pages you want to execute an action (the action only gets executed on "checked" pages).
  3. Select the action and if necessary, additional data like the new parent or the new template.
  4. Execute.

Supported actions:

  • Publish/Unpublish Pages
  • Hide/Unhide Pages
  • Lock/Unlock Pages
  • Trash Pages
  • Delete Pages
  • Change Parent
  • Change Template

Batcher does the following permission checkings for the current user:

  • Don't display pages that are not editable
  • Remove Actions if the user doesn't have the permissions (page-delete, page-move, page-template, page-lock)

Important notes:

When changing a template, data in fields of the old template which are not assigned to the new template gets deleted.

When changing the parent, the template of the new parent must accept the pages template as children. This is a setting in the template under "family".

Creating

How does it work?

  1. Select a parent where your new pages will be added as children
  2. Add as many pages as you want by clicking "add Page"
  3. Click "Create Pages"

You must enter a title and choose a template. The name is optional: If left empty, Pw will generate this for you.

Includes permission checking and Family template restrictions. This means in detail:

  • The selected parent must accept children and their template
  • The pages template must accept the parents template
  • User needs the permission to add children to the selected parents template
  • User needs the permission to create Pages for the chosen Template

Batch-creating tips

The chosen template and the statuses are always cloned from the last row. So if you need to add 30 pages

with the same template, define it first and the click "add Page" - it'll make your life easier ;-)

You can drag & drop the table rows should you want to change the order. The dragging looks ugly but it works.

For the lazy dogs and keybord hackers among us, you can add a new row by pressing "ctrl+n".
This works (at least in firefox) only if no input has focus. After adding a new row, the title input gets the focus.

By pressing 3 times tab you arrive at the published-checkbox, here the short-cut works.

Restrict Batcher for a user to only allow editing or creating

Create permissions "batcher-edit" and/or "batcher-add". As soon those exists, the module checks if the current

user has the permissions.

If you only need batch creating, check out the following module by Soma:

http://processwire.com/talk/topic/2138-process-tools-create-pages-wip/

Cheers

  • Like 35
Link to comment
Share on other sites

Looks awesome, thanks @Wanze! This'll come in handy especially for some of our bigger sites, I'm sure :)

@Luis: some things can't be unseen. Going to have difficult time maintaining serious expression while introducing this module to coworkers or clients, simultaneously avoiding this image of dancing badgers..

  • Like 1
Link to comment
Share on other sites

Thanks guys, let me know what you think and how I could improve the module.

Some possible actions to add:

- Change User

- Change Created-date

@SiNNut

To be honest, I knew that modx had a Tool called Batcher.

I was thinking some time of a good name and finally decided to name it Batcher too, not very creative I know :)

Batchman was another idea, based on Anti's Trashman.

My concern is that if someone sees the modules title or searches for it, the current name is more suitable than badger?

But I'm open for every suggestion, so maybe we can collect some ideas and make a poll? :)

  • Like 1
Link to comment
Share on other sites

Did quick test.

I don't see any Status in the results.

It doesn't see unpublished pages. It doesn't see hidden pages.

At the moment, the status(es) are displayed when a page is: unpublished, hidden, locked or trashed

So for a normal page there's no status.

I don't know, does it make sense to display also a status for the complement?

Published, not hidden, not locked, not trashed

Did you add "include=hidden" or "include=all" to your selector?

Link to comment
Share on other sites

It would be nice. No I didn't, but also thought it should add that anyway for all, or maybe a checkbox to include all?



I can't sort the columns. I think there's an option to enable it in the DataTable.

  • Like 1
Link to comment
Share on other sites

Just comitted v 1.0.1 to Github:

- Added checkboxes for include=hidden, include=all so you no longer need to write those in the selector

- Made AdminDataTable sortable

- Each status is now in its own column - this means you can also sort the results by status

- Added message: number of pages found


post-582-0-09027000-1361218014_thumb.png

I initially disabled the sorting on the table because there was an issue with the checkbox in the first <th> which can be used to toggle all the checkboxes.

The solution is to disable the sorting of a specific column with jqueryTableSorter:

$.tablesorter.defaults.headers = {0:{sorter:false}};

...where 0 = first column, 1 = second and so on, should anyone else ever need this.

  • Like 5
Link to comment
Share on other sites

This looks like a great module Wanze!

I have a suggestion: It would be great to be able to click on the title of a page and open that page for editing in a lightbox overlay :) not sure how easy this is though.

I can see a great use for this as a quick SEO overview as the title, name (url) and parent (parent url) are shown. Further to that - it would be great to be able to have this available with reduced privileges for roles less than the superuser (with just the ability to see the list and perform actions applicable to their selected roles).

  • Like 1
Link to comment
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 monollonom
      (once again I was surprised to see a work of mine pop up in the newsletter, this time without even listing the module on PW modules website 😅. Thx @teppo !)
      FieldtypeQRCode
      Github: https://github.com/romaincazier/FieldtypeQRCode
      Modules directory: https://processwire.com/modules/fieldtype-qrcode/
      A simple fieldtype generating a QR Code from the public URL of the page, and more.
      Using the PHP library QR Code Generator by Kazuhiko Arase.

      Options
      In the field’s Details tab you can change between .gif or .svg formats. If you select .svg you will have the option to directly output the markup instead of a base64 image. SVG is the default.
      You can also change what is used to generate the QR code and even have several sources. The accepted sources (separated by a comma) are: httpUrl, editUrl, or the name of any text/URL/file/image field.
      If LanguageSupport is installed the compatible sources (httpUrl, text field, ...) will return as many QR codes as there are languages. Note however that when outputting on the front-end, only the languages visible to the user will be generated.
      Formatting
      Unformatted value
      When using $page->getUnformatted("qrcode_field") it returns an array with the following structure:
      [ [ "label" => string, // label used in the admin "qr" => string, // the qrcode image "source" => string, // the source, as defined in the configuration "text" => string // and the text used to generate the qrcode ], ... ] Formatted value
      The formatted value is an <img>/<svg> (or several right next to each other). There is no other markup.
      Should you need the same markup as in the admin you could use:
      $field = $fields->get("qrcode_field"); $field->type->markupValue($page, $field, $page->getUnformatted("qrcode_field")); But it’s a bit cumbersome, plus you need to import the FieldtypeQRCode's css/js. Best is to make your own markup using the unformatted value.
      Static QR code generator
      You can call FieldtypeQRCode::generateQRCode to generate any QR code you want. Its arguments are:
      string $text bool $svg Generate the QR code as svg instead of gif ? (default=true) bool $markup If svg, output its markup instead of a base64 ? (default=false) Hooks
      Please have a look at the source code for more details about the hookable functions.
      Examples
      $wire->addHookAfter("FieldtypeQRCode::getQRText", function($event) { $page = $event->arguments("page"); $event->return = $page->title; // or could be: $event->return = "Your custom text"; }) $wire->addHookAfter("FieldtypeQRCode::generateQRCodes", function($event) { $qrcodes = $event->return; // keep everything except the QR codes generated from editUrl foreach($qrcodes as $key => &$qrcode) { if($qrcode["source"] === "editUrl") { unset($qrcodes[$key]); } } unset($qrcode); $event->return = $qrcodes; })
    • By Sebi
      AppApiFile adds the /file endpoint to the AppApi routes definition. Makes it possible to query files via the api. 
      This module relies on the base module AppApi, which must be installed before AppApiFile can do its work.
      Features
      You can access all files that are uploaded at any ProcessWire page. Call api/file/route/in/pagetree?file=test.jpg to access a page via its route in the page tree. Alternatively you can call api/file/4242?file=test.jpg (e.g.,) to access a page by its id. The module will make sure that the page is accessible by the active user.
      The GET-param "file" defines the basename of the file which you want to get.
      The following GET-params (optional) can be used to manipulate an image:
      width height maxwidth maxheight cropX cropY Use GET-Param format=base64 to receive the file in base64 format.
    • By MarkE
      This fieldtype and inputfield bundle was built for storing measurement values within a field, rendering them in a variety of formats and converting them to other units or otherwise modifying them via the API.
      The API consists of a number of predefined functions, some of which include...
      render() for rendering the measurement object, valueAs() for converting the value to another unit value, convertTo() for converting the whole measurement object to different units, and add() and subtract() for for modifying the stored value by the value (converted as required) in another measurement. In the admin the inputfield includes a checkbox (which can be optionally disabled) for converting values on page save. For an example if a value was typed in as centimeters, the unit was changed to metres, and the page saved with this checkbox selected, said value would be automatically converted so that e.g. 170 cm becomes 1.7 m.

      A simple length field using Fieldtype Measurement and Inputfield Measurement.
      Combination units (e.g. feet and inches) are also supported.
      Please note that this module is 'proof of concept' at the moment - there are limited units available and quite a lot of code tidying to do. More units will be added shortly.
      See the GitHub at https://github.com/MetaTunes/FieldtypeMeasurement for full details and updates.
    • By tcnet
      File Manager for ProcessWire is a module to manager files and folders from the CMS backend. It supports creating, deleting, renaming, packing, unpacking, uploading, downloading and editing of files and folders. The integrated code editor ACE supports highlighting of all common programming languages.
      https://github.com/techcnet/ProcessFileManager

      Warning
      This module is probably the most powerful module. You might destroy your processwire installation if you don't exactly know what you doing. Be careful and use it at your own risk!
      ACE code editor
      This module uses ACE code editor available from: https://github.com/ajaxorg/ace

      Dragscroll
      This module uses the JavaScript dragscroll available from: http://github.com/asvd/dragscroll. Dragscroll adds the ability to drag the table horizontally with the mouse pointer.
      PHP File Manager
      This module uses a modified version of PHP File Manager available from: https://github.com/alexantr/filemanager
       
    • By tcnet
      This module implements the website live chat service from tawk.to. Actually the module doesn't have to do much. It just need to inserted a few lines of JavaScript just before the closing body tag </body> on each side. However, the module offers additional options to display the widget only on certain pages.
      Create an account
      Visit https://www.tawk.to and create an account. It's free! At some point you will reach a page where you can copy the required JavaScript-code.

      Open the module settings and paste the JavaScript-code into the field as shown below. Click "Submit" and that's all.

      Open the module settings
      The settings for this module are located int the menu Modules=>Configure=>LiveChatTawkTo.

       
×
×
  • Create New...