Module Batch Child Editor

[sww]

1 hour ago, adrian said:

They'll be copied to the page's assets/files/xxxx folder. It will be up to you to manually remove them from your temp folder.

Okay. Thanks!

[lpa]

I tried to find info on how to import a page hierarchy with Batch Child Editor:

FirstLevel1
FirstLevel1/Child1/
FirstLevel1/Child2/
FirstLevel2
FirstLevel2/Child1/
FirstLevel2/Child2/

Is this possible, or should I first create the first level-pages and then import the second level pages one parent at a time?

[adrian]

@lpa - BCE only supports one level of importing. If you're importing content along with the second level pages, then you'll need to create the first pages first, but if you're just trying to create a hierarchy of pages with titles only for now, then this might help: https://processwire.com/modules/admin-actions-unordered-list-to-pages/

Otherwise, I tend to do all my complex imports these days with a custom AdminActions action. This is great if you have a complex CSV export from an old site - not sure if this is what you are doing or not, but just in case:

I find this approach really useful as I can quickly do test imports and continue to tweak until I have everything correct. It even allows importing specific items from the CSV (by ID, or some other field if you want). You can then easily remove all test imports and do a full import of everything.

[lpa]

Great, the UnorderedListToPages Action did just what I needed. Is that Import Media action available somewhere is just in your custom use?

[adrian]

1 minute ago, lpa said:

Is that Import Media action available somewhere is just in your custom use?

It's something I built for my own use. I am constantly creating new / modified versions of it for all sorts of imports. Here is a copy of what I am currently using for that version:

Spoiler

<?php

set_time_limit(0);
ini_set('memory_limit','1024M');

class ImportMedia extends ProcessAdminActions {

    protected $title = 'Import Media';
    protected $description = 'Imports media items';
    protected $notes = "Put media.csv file into /site/templates/AdminActions/csv";


    protected function defineOptions() {
        $csvFiles = $this->wire('files')->find($this->wire('config')->paths->templates . 'AdminActions/csv');
        $typeOptions = array('' => 'Choose One');
        foreach($csvFiles as $csvFile) {
            $contentType = pathinfo($csvFile, PATHINFO_FILENAME);
            $typeOptions[$contentType] = ucfirst($contentType);
        }

        return array(
            array(
                'name' => 'removeExisting',
                'label' => 'Remove existing publications',
                'description' => 'This will remove existing publications',
                'type' => 'checkbox'
            ),
            array(
                'name' => 'howMany',
                'label' => 'How Many',
                'description' => 'How many to import',
                'type' => 'select',
                'required' => true,
                'options' => array(
                    '1' => '1',
                    '2' => '2',
                    '10' => '10',
                    '25' => '25',
                    '50' => '50',
                    '100' => '100',
                    'all' => 'All',
                    'byId' => 'One by ID'
                )
            ),
            array(
                'name' => 'imageId',
                'label' => 'Image ID',
                'showIf' => 'howMany=byId',
                'type' => 'integer'
            ),

        );
    }


    protected function executeAction($options) {

        $howMany = $options['howMany'];

        if($options['removeExisting']) {
            foreach($this->wire('pages')->find("template=media, include=all") as $child) {
                $child->delete();
            }
        }


        require_once './includes/parsecsv.lib.php';

        $csvStr = file_get_contents(__DIR__ . '/csv/media.csv');

        // iterate through all rows to create child pages
        $rows = new \parseCSV();
        $rows->encoding('UTF-16', 'UTF-8');
        $rows->heading = true;
        $rows->delimiter = ',';
        $rows->enclosure = '"';
        $rows->parse($csvStr);

        foreach($rows->data as $i => $row) {

            if($howMany == 'byId' && $row['pid'] != $options['imageId']) continue;
            if($howMany !== 'byId' && $i >= $howMany && $howMany != 'all') break;
            $existingPage = $this->wire('pages')->get('template=media, old_id="'.$row['pid'].'"');
            if(!$existingPage->id) {
                $p = new Page();
                $p->of(false);
                $p->template = 'media';
                $p->parent = 4852;
                $title = html_entity_decode($row['title']);
                $title = htmlspecialchars_decode($title, ENT_QUOTES);
                $title = trim($title, '.');
                $p->title = $title;
                $p->save();
            }
            else {
                $p = $existingPage;
                $p->of(false);
            }

            foreach($p->fields as $f) {

                if($f->name == 'title') {
                    continue;
                }
                elseif($f->name == 'image') {

                    $p->image->removeAll();
                    $p->save('image');
                    $p->image = 'https://mysite.com/imagelibrary/albums/'.$row['filepath'].$row['filename'];
                }
                elseif($f->name == 'date') {
                    $p->$f = strtotime($row['user3']);
                }
                elseif($f->name == 'people') {
                    $owners = explode(',', $row['user1']);
                    $authorsStr = '';
                    foreach($owners as $owner) {
                        $name = explode(' ', $owner, 2);
                        $u = $this->wire('pages')->get('template=staff, first_name='.$name[0].', last_name='.$name[1]);
                        if($u->id) {
                            $p->$f->add($u);
                        }
                        else {
                            $authorsStr .= $owner . ', ';
                        }
                    }
                    $p->authors = trim($authorsStr, ', ');
                }
                elseif($f->name == 'media_type') {
                    if($row['user4'] == 'Vector Graphic' || $row['user4'] == 'Raster Graphic') {
                        $p->$f = $this->wire('pages')->get(4850);
                    }
                    elseif($row['user4'] == 'Video') {
                        $p->$f = $this->wire('pages')->get(4851);
                    }
                    else {
                        $p->$f = $this->wire('pages')->get(4849);
                    }
                }
                elseif($f->name == 'vector_or_raster') {
                    $p->$f = pathinfo($row['filename'], PATHINFO_EXTENSION) == 'svg' ? 'Vector' : 'Raster';
                }
                elseif($f->name == 'media_album') {
                    $p->$f = $this->wire('pages')->get('template=media_album, old_id='. $row['aid']);
                }
                elseif($f->name == 'keywords') {
                    $keywords = explode(',', $row['keywords']);
                    $target = array('symbol', 'vector', 'illustration');
                    if(count(array_intersect($keywords, $target)) == count($target)) {
                        $p->is_symbol = 1;
                        unset($keywords[0]);
                        unset($keywords[1]);
                        unset($keywords[2]);
                    }
                    $p->$f = implode(', ', $keywords);
                }
                elseif($f->name == 'projects') {
                    foreach(explode(',', $row['user5']) as $id) {
                        $p->$f->add($this->wire('pages')->get('template=project, old_id='.$id));
                    }
                }
                else {
                    $trans = array(
                        "old_id" => "pid",
                        "body" => "caption"
                    );
                    $rowFieldName = strtr($f->name, $trans);
                    if(isset($row[$rowFieldName])) {
                        $value = html_entity_decode($row[$rowFieldName]);
                        $value = htmlspecialchars_decode($value, ENT_QUOTES);
                        $p->$f = $value;
                    }
                }
            }
            $p->created = $row['ctime'];

            $p->save(array('quiet' => true));

        }

        $this->successMessage = 'Success';
        return true;

    }

}

 

Obviously you'll need to make a lot of changes to have anything useful to you, but it's a good starting point.

Also note that I am making use of this CSV library: https://github.com/parsecsv/parsecsv-for-php so you'll need to grab that so it can be included.

[Matthieu]

Hi @adrian ? first, many thanks for your module ! it help me a lot.

Unfortunately, I'm facing with a bug/problem.
I have a store pages with a mapMArker field, all fine when I export, the data are well inside de CSV but when I try to import this CSV the mapMarker field is not filled ans display the default value.

Any idea ?

Thanks

Note: I created a hook function (Pages::saveReady)  who copy/paste address in the address field of the mapMarker and use your module to resave all entries and then all is fine

[adrian]

HI @Matthieu - I've just added support for the MapMarker field type. Please update and let me know if you find any problems.

[Matthieu]

Hi @adrian - It's perfectly working ! Many thanks from Belgium

[Kiwi Chris]

I get the following error on attempting to import a CSV file:

Quote

Parse Error: syntax error, unexpected 'class' (T_CLASS), expecting identifier (T_STRING) or variable (T_VARIABLE) or '{' or '$' (line 63 of site/modules/BatchChildEditor/parsecsv-for-php/src/extensions/DatatypeTrait.php)

I'm running ProcessWire 3.0.171, on PHP 7.4x 

 

[adrian]

Hi @Kiwi Chris - I haven't ever seen that which is strange.

Would you mind doing me a favour and reporting that here: https://github.com/parsecsv/parsecsv-for-php/issues 

Thanks!

[Kiwi Chris]

On 3/8/2021 at 4:45 PM, adrian said:

Hi @Kiwi Chris - I haven't ever seen that which is strange.

Would you mind doing me a favour and reporting that here: https://github.com/parsecsv/parsecsv-for-php/issues 

Thanks!

I figured out the problem. The hosting control panel said that PHP 7.4 was installed but it was actually only supplying 5.4. I got that fixed and the module works now.

[sirhc]

Hi @adrian, great module!

I am wondering if there is an option to include the system fields into the export, or help me with some code that I can add to the module to do this?

If this is not possible, some help getting me to include the page id into the export is also great.

Hope anyone can help! Thanks.

[adrian]

@sirhc - you can already export system fields, include the page ID.

There are two ways to do this:

1) Make the parent page separately configurable and then visit the BCE settings on that page's Settings tab and choose the fields you want included in the export.

2) In the Module's CSV export settings, allow the user to override the CSV settings and then when they export, they can choose exactly the fields they want on each export.

[sirhc]

@adrian ah that's fantastic! Thanks for your fast reply!

[pwfans]

Hello,
On my PW tree, some of parents have thousands child pages, and some tens of thousands child pages, using BCE load child pages is heavy and cannot using edit mode because of error memory/timeout.
Is that possible to add pagination like on edit mode just like lister mode ? or is there any way to use this module with thousands child pages ?

 

[adrian]

@pwfans - I always disable BCE for pages that have too many children for the edit mode to handle. I don't really think the edit mode makes much sense with that many pages anyway so I don't think pagination will help. If you need to batch edit that many child pages you probably need to write a script via the API (Tracy Console panel or AdminActions perhaps?) to make the changes.

[pwfans]

16 hours ago, adrian said:

@pwfans - I always disable BCE for pages that have too many children for the edit mode to handle. I don't really think the edit mode makes much sense with that many pages anyway so I don't think pagination will help. If you need to batch edit that many child pages you probably need to write a script via the API (Tracy Console panel or AdminActions perhaps?) to make the changes.

Ahh ok, too bad BCE can't handle many pages, it's already has a nice interface for bulk edit. 

[adrian]

4 hours ago, pwfans said:

Ahh ok, too bad BCE can't handle many pages, it's already has a nice interface for bulk edit. 

But how nice would that interface actually be for hundreds / thousands of pages? What sort of bulk edit actions are you referring to? Changing status, or deleting etc? I suppose there could be a way to select all across all pages if they were to be paginated. I'm afraid I just don't see it as the right tool for the job in this case, but if you want to add support for this, I'm happy to accept a PR.

[pwfans]

15 hours ago, adrian said:

But how nice would that interface actually be for hundreds / thousands of pages? What sort of bulk edit actions are you referring to? Changing status, or deleting etc? I suppose there could be a way to select all across all pages if they were to be paginated. I'm afraid I just don't see it as the right tool for the job in this case, but if you want to add support for this, I'm happy to accept a PR.

For example, sometimes we need to change title/name/template for about 80 pages from about 600+ pages.
We use PW for intranet application.
Thank you for your offer anyway @adrian, we will discuss this with our IT staff first.

[adrian]

@pwfans - I wonder, do you have a copy of ListerPro? This might be a better option for your needs. It's inline editing isn't quite as convenient as BCE's, but it has pagination and searching and so it  scales infinitely.

[michelangelo]

Hi @adrianthank you for the module, I have been using it for years on and off and it has saved tons of work!

I have a question regarding inline editing. I know it has been asked a lot but I have only 1 field to edit per page and wondered if I can go without purchasing ListerPro?

This is how my setup looks like. Imagine that I just have to pick some categories in Category Reference and potentially delete the page. Can you give me a hint/direction how I can approach this?

Thank you!
  

[adrian]

@michelangelo - the non-pro version of the Lister doesn't support inline editing. If you don't want to buy ListerPro, then you could perhaps modify the normal BCE edit mode to support custom fields (that wouldn't be too hard actually). The more complicated part would be building in the pagination, which BCE doesn't currently have, although it really does need it, especially with your setup with 3346 child pages. I don't really have time to work on adding those things any time soon, but they would make great additions if someone wants to contribute via a PR.

[maddmac]

@adrianAdrian, great tool that I continue to use. Is there an option in the setup config to prevent duplicate records from importing via CSV? My titles are unique and would rather not automatically remove records that are duplicates. if the Import would detect a duplicate title and ignore duplicate entries instead of adding new records. 

[Martinus]

Hi, through Tracy I get the error 'undefined offset: 0, in BatchChildEditor.module.php: 1174
It only happens when adding a new child. Not when I am updating a child.

I opened the file and it says:

//use the selected template or if none selected then it means there is only one childTemplate option [0], so use that

1174      $childTemplate = $this->wire('input')->post->childTemplate ? $this->wire('input')->post->childTemplate : $pp->template->childTemplates[0];

 

Is there an update or fix?

[adrian]

Hi @Martinus - I am not sure what scenario would result in that but it might help if you can provide a screenshot to show this so I can see what options for Child Template are available. The error suggest that there are none, but not really sure how that would happen unless you have the page locked down so that there are no allowed child templates. Actually, you should check the family settings for the template of the parent page to confirm that as well.