Xavier: How do we find documentation for new features?

[bellini13]

Xavier: In your v1.6.0.13 release post you stated 3 new enhancements were introduced

https://www.prestashop.com/forums/topic/418728-prestashop-16013-is-available-for-download/?do=findComment&comment=1978930

 

Among the 200 improvements, the 5 most anticipated by our community are:

- Big work on refund and partial refund

- New front office classes added to facilitate integration

- Ability to override specific controllers with ModuleAdminControler

 

Where or when will Prestashop document what these enhancements actually are?

 

1) What does 'big work on refund' actually mean?  Did you enhance refunds?  Did you fix something that was broken?  What affect does this have to the existing refund process?

 

2) What are the new front office classes?  I compared .11 to .13 and there are no new classes.  If they exist somewhere other than classes or controllers, where are they and how do they help facilitate integration?  Integration to what?

 

3) What is ModuleAdminControler and how does it help to override specific controllers?  What are the 'specific controllers'?

 

I'm sure these are great features, but I am having a hard time being excited about them, because I have no clue what they are...

Edited February 27, 2015 by bellini13 (see edit history)

[Xavier Borderie]

Hey bellini13.

 

I am the Xavier in charge of the documentation (by contract with That Other Xavier, who's much more on this forum than I am ).

 

You're right, the doc is not updated yet. I'm putting the final touch on another project, which took some time. I plan on getting this information on the doc site as soon as possible.

 

Still, I can start answering you here and there:

• "Big work on refund and partial refund":
  • This means that we have improved the calculation methods for refunds, which should now be much more accurate.
• "New front office classes added to facilitate integration" : those classes are:
  • Those are actually CSS classes: https://github.com/PrestaShop/PrestaShop/commit/b9927211e671bb6dbe80951d2f14d0f242554b0a
    I guess someone only read the title of the commit, and got overly excited about it
• "Ability to override specific controllers with ModuleAdminControler":
  • The one developer in charge of this is currently on jury duty, so I won't be able to get the full details until he comes back, in two weeks :/ In the meantime, I'll do my best documenting what the rest of the teams knows about this.

Cheers!

[bellini13]

Hi Xavier, ok thank you for your reply and feedback.

 

I would be quite interested in the override feature.  I suspect this might be the ability to override module files, which has been long awaited.  I have also seen several reports in the forums of that not working properly, so without the proper documentation, it is difficult to say if there is a defect somewhere, or if they are just doing it wrong.

[Xavier Borderie]

I too am interested in this!

If nothing comes within two weeks, don't hesitate to bump this topic or mail me directly: [email protected]

[Dh42]

Bellini, That has been in since a couple of versions ago, but alas it is undocumented as well. Here is an article Nemo wrote about it http://nemops.com/override-prestashop-modules-core/#.VPU0mPnF9HQ

[bellini13]

Yes, I concur.  However there is a subtle difference.  Nemo's tutorial shows overriding the main module file, while these changes specifically reference the module front controller. 

 

The punch line here however is the failure to accurately document new features.  It is quite difficult to be excited about a new release, when no one has any clue what was just released.  It is also quite difficult to support the community when you have no clue what needs to be supported...