automatic update of the TOC to fix page number missing issues

[jgiacomello]

Description

On several trials, I noticed that despite using $phpWord->getSettings()->setUpdateFields(true);, when the generated file was first opened, the chapter index only updated the page numbers and not the list as well, thus losing the references to any paragraphs (H2 and H3) in the document.
On subsequent openings of the file, Word requests the updating of the table of contents fields, but requires the user to specifically select the "update entire table of contents" option, so in the case of a different choice ("update page numbers only") the references to the paragraphs present in each chapter are lost, as mentioned above.

The change made in PhpWord/Writer/Word2007/Element/TOC.php on line 116 allows the entire table of contents to be automatically updated by only requiring the generic update of the fields, but without requiring the second step, whatever the number of file openings.

Fixes #1691 #1396

Checklist:

• I have run composer run-script check --timeout=0 and no errors were reported
• The new code is covered by unit tests (check build/coverage for coverage report)
• I have updated the documentation to describe the changes

[coveralls]

coverage: 97.217%. remained the same
when pulling 79effbe on jgiacomello:TOC_numbers_fix
into 2f4da6e on PHPOffice:master.

[Progi1984]

@jgiacomello Hi, Could you update the changelog and add some unit tests, please ?

[jgiacomello]

@Progi1984 Hi, thankyou for your feedback!
I updated the changelog and tried to add the tests, but I don't know if they are correct because indeed it seems that the library does not insert page numbers unless they are explicitly indicated when entering a new title, thus leaving the “responsibility” of completion to the actual opening of the file via Word. So I wouldn't know how to really test their correctness, I just know that with that modification they do eventually show up.

Speaking of which, I noticed that with the most updated version of word (2408) the page numbers do show up, but all at 1. They only fix themselves after a manual update of the table of contents.

Thanks

[Progi1984]

@jgiacomello Could you rebase please the PR ?

And I have added a last comment.
After that, it will be a merge.

[coveralls]

coverage: 96.757% (+0.008%) from 96.749%
when pulling 6179b97 on jgiacomello:TOC_numbers_fix
into 66f0a2c on PHPOffice:master.

[Progi1984]

Thanks @jgiacomello for your contribution 🥳