EC-CUBE3プラグイン勉強会

Transcript

1. EC-CUBE3ϓϥάΠϯษڧձ EC-CUBEؔ੢Ϣʔβάϧʔϓ 2016-04-27
2. ໨࣍ 1. ϓϥάΠϯͷ֓ཁ 2. ϓϥάΠϯͷ࡞੒खॱ 3. ϓϥάΠϯࢀߟ
3. 1.ϓϥάΠϯͷ֓ཁ
4. ϓϥάΠϯͷ֓ཁ • EC-CUBE3.0.9͔ΒϓϥάΠϯػߏ͕มߋ͞Ε·ͨ͠ɻ ओͳมߋ఺͸ϓϥάΠϯ࢓༷ॻΛ֬ೝ͍ͯͩ͘͠͞ɻ • ޙํޓ׵ੑ͸࢒͍ͯ͠·͕͢ɺࠓճ͸৽͘͠ͳͬͨϓ ϥάΠϯػߏΛݩʹઆ໌Λߦ͍·͢ɻ
5. 2.ϓϥάΠϯͷ࡞੒खॱ
6. ϓϥάΠϯͷ࡞੒खॱ • ࠓճͷαϯϓϧͰ͸؆қϥοϐϯάରԠදࣔϓϥάΠϯͱ͍͏ ϓϥάΠϯΛݩʹઆ໌͠·͢ɻ
 https://github.com/k-yamamura/eccube3-new-sample-plugin • ͜ͷϓϥάΠϯͷ಺༰ͱͯ͠ɺ
 ʮ঎඼ߪೖ࣌ʹϥοϐϯάͷ༗ແΛબ୒Մೳʯ
 ʮϓϥάΠϯઃఆը໘ͰϥοϐϯάදࣔՄ൱Λઃఆʯ
 ͱ͍͏ಈ࡞Λ͠·͢ɻ

7. ϓϥάΠϯͷ࡞੒खॱ • ϓϥάΠϯͷ࡞੒खॱͱͯ͠ɺओʹҎԼͱͳΓ·͢ɻ 1. ϓϥάΠϯ༻σΟϨΫτϦͷ࡞੒ 2. config.ymlͷ࡞੒ 3. event.ymlͷ࡞੒ 4. PluginManagerΫϥεͷ࡞੒ 5. EventΫϥεͷ࡞੒ 6. ServiceProviderΫϥεͷ࡞੒ 7. consoleίϚϯυΛར༻ͨ͠ϓϥάΠϯ։ൃ
8. ϓϥάΠϯͷ࡞੒खॱ • ϓϥάΠϯ༻σΟϨΫτϦ࡞੒
 ECCUBEROOT/app/PluginσΟϨΫτϦ௚Լʹϓϥά Πϯ༻ͷσΟϨΫτϦΛ࡞੒͠·͢ɻ ECCUBEROOT/app/Plugin/Xxxx !Xxxx͸config.ymlʹهड़͢Δcodeͱ߹Θ ͤΔඞཁ͕͋Γɺ1จࣈ໨͸ඞͣӳ൒֯େจࣈ ʹ͢Δඞཁ͕͋Γ·͢ɻ
9. ϓϥάΠϯͷ࡞੒खॱ • config.ymlͷ࡞੒
 ϓϥάΠϯσΟϨΫτϦ௚Լʹconfig.ymlΛ࡞੒͠· ͢ɻconstͱݺ͹ΕΔͱఆ਺΋هड़Մೳ͕ͩɺϓϥάΠ ϯ͕ແޮͷ৔߹ɺ͜ͷఆ਺͸ಡΈࠐΊ·ͤΜɻ name: GiftWrappingϓϥάΠϯ ※ඞਢ code: GiftWrapping ※ඞਢ version: 1.0.0 ※ඞਢ service: - GiftWrappingServiceProvider orm.path: - /Resource/doctrine ※ϓϥάΠϯͰ௥Ճͨ͠ςʔϒϧΛ࡞੒͢Δ৔߹ɺorm.pathͷهड़͸ඞਢ event: GiftWrappingEvent ※eventΛ௥Ճ͢Δ৔߹ɺeventͷهड़͸ඞਢ
10. ϓϥάΠϯͷ࡞੒खॱ • event.ymlͷ࡞੒
 ΠϕϯτΛར༻͢Δ৔߹ɺevent.ymlΛ࡞੒͢Δඞཁ͕ ͋Γ·͢ɻ3.0.9͔Β৽ͨͳΠϕϯτ͕༻ҙ͞Ε͍ͯ· ͢ɻ front.shopping.index.initialize: - [onShoppingIndexInitialize, NORMAL] Shopping/index.twig: - [onShoppingIndexRender, NORMAL]
11. ϓϥάΠϯͷ࡞੒खॱ • PluginManagerΫϥεͷ࡞੒
 ϓϥάΠϯͷΠϯετʔϧ΍༗ޮɺແޮ࣌ͷઃఆΛߦ͏ PluginManager.phpϑΝΠϧΛ࡞੒͠·͢ɻͪ͜ΒͷΫ ϥεͰϓϥάΠϯ͕Πϯετʔϧ͞Εͨ࣌ͷॲཧ΍ɺ༗ ޮʹͳͬͨ࣌ɺແޮʹͳͬͨ࣌ͷॲཧΛهड़͠·͢ɻ
12. ϓϥάΠϯͷ࡞੒खॱ <?php namespace Plugin\GiftWrapping; use Eccube\Plugin\AbstractPluginManager; use Symfony\Component\Filesystem\Filesystem; class PluginManager extends AbstractPluginManager { /** * @var string ίϐʔݩϦιʔεσΟϨΫτϦ */ private $origin; /** * @var string ίϐʔઌϦιʔεσΟϨΫτϦ */ private $target; public function __construct() { // ίϐʔݩͷσΟϨΫτϦ $this->origin = __DIR__.'/Resource/assets'; // ίϐʔઌͷσΟϨΫτϦ $this->target = '/giftwrapping'; } /** * ϓϥάΠϯΠϯετʔϧ࣌ͷॲཧ * * @param $config * @param $app * @throws \Exception */ public function install($config, $app) { // ϦιʔεϑΝΠϧͷίϐʔ $this->copyAssets($app); }
13. ϓϥάΠϯͷ࡞੒खॱ • EventΫϥεͷ࡞੒
 event.ymlͰఆٛ͞Ε֤ͨΠϕϯτʹରԠ͢Δϝιου ΛEventΫϥεʹ࡞੒͠·͢ɻϓϥάΠϯ͕ೝࣝ͞ΕΔ ͱconfig.ymlʹevent͕ఆٛ͞Ε͍ͯΕ͹ɺ͜ͷEventΫ ϥεͰఆٛ͞Ε͍ͯΔؔ਺ͱevent.ymlͰఆٛͨ͠಺༰ ΛϚοϐϯάͯ͠EC-CUBE༻Πϕϯτ͕࣮ߦ͞ΕΔΑ ͏ʹͳΓ·͢ɻ
14. ϓϥάΠϯͷ࡞੒खॱ <?php namespace Plugin\GiftWrapping; use Eccube\Event\EventArgs; use Eccube\Event\TemplateEvent; class GiftWrappingEvent { /** @var \Eccube\Application $app */ private $app; public function __construct($app) { $this->app = $app; } public function onShoppingIndexInitialize(EventArgs $event) { // ϑΥʔϜͷ௥Ճ // FormBuilderͷऔಘ $builder = $event->getArgument('builder'); // ߲໨ͷ௥Ճ $builder->add('gift_wrapping', 'choice', array( 'choices' => array( '1' => 'ͷ͠ͷΑ͏ͳ΋ͷ', '2' => 'ϦϘϯ', '3' => 'ࢴแΈ', ), 'expanded' => false, 'multiple' => false, 'required' => false, 'empty_value' => 'ϥοϐϯάͳ͠', 'mapped' => false, )); } public function onShoppingIndexRender(TemplateEvent $event) {
15. ϓϥάΠϯͷ࡞੒खॱ • ServiceProviderΫϥεͷ࡞੒
 ϓϥάΠϯσΟϨΫτϦ௚ԼʹServiceProviderσΟϨΫτ ϦΛ࡞੒͠ɺͦͷ഑ԼʹServiceProviderΫϥεΛ࡞੒͠ ·͢ɻ͜ͷΫϥε͸ɺϧʔςΟϯά΍ఆٛϑΝΠϧɺϓϥ άΠϯͰར༻͢ΔϦϙδτϦΫϥεͳͲΛఆٛ͢ΔͨΊʹ ༻ҙ͞Ε·͢ɻϓϥάΠϯ͕ೝࣝ͞ΕΔͱconfig.ymlʹ service͕ఆٛ͞Ε͍ͯΕ͹ɺServiceProviderΫϥεΛݩ ʹઃఆ͕ར༻͞ΕΔΑ͏ʹͳΓ·͢ɻ
16. ϓϥάΠϯͷ࡞੒खॱ <?php namespace Plugin\GiftWrapping\ServiceProvider; use Eccube\Application; ɾɾɾɾ ɾɾɾɾ class GiftWrappingServiceProvider implements ServiceProviderInterface { public function register(BaseApplication $app) { // // ϝοηʔδొ࿥ $app['translator'] = $app->share($app->extend('translator', function ($translator, \Silex\Application $app) { $translator->addLoader('yaml', new \Symfony\Component\Translation\Loader\YamlFileLoader()); $file = __DIR__.'/../Resource/locale/message.'.$app['locale'].'.yml'; if (file_exists($file)) { $translator->addResource('yaml', $file, $app['locale']); } return $translator; })); // load config $conf = $app['config']; $app['config'] = $app->share(function () use ($conf) { $confarray = array(); $path_file = __DIR__.'/../Resource/config/path.yml'; if (file_exists($path_file)) { $config_yml = Yaml::parse(file_get_contents($path_file)); if (isset($config_yml)) { $confarray = array_replace_recursive($confarray, $config_yml); } } $constant_file = __DIR__.'/../Resource/config/constant.yml'; if (file_exists($constant_file)) { $config_yml = Yaml::parse(file_get_contents($constant_file)); if (isset($config_yml)) { $confarray = array_replace_recursive($confarray, $config_yml); }
17. ϓϥάΠϯͷ࡞੒खॱ • consoleίϚϯυΛར༻ͨ͠ϓϥάΠϯ։ൃ
 ϓϥάΠϯ։ൃ࣌ɺҰ୴ΞʔΧΠϒͨ͠ޙϓϥάΠϯͷΠϯετʔϧΛߦ͏ඞཁ ͕͋Γ·͕͢ɺEC-CUBE3.0.9͔ΒίϚϯυϕʔεͰ։ൃͷखॿ͚Λߦ͏खॱ͕ఏ ڙ͞Ε͍ͯ·͢ɻৄ͘͠͸ԼهURLΛࢀর͍ͯͩ͘͠͞ɻ
 http://ec-cube.github.io/plugin_console.html
 
 
 
 
 
 
 
 php app/console plugin:develop install --code=Xxxx --codeύϥϝʔλʹ͸ར༻͍ͨ͠ϓϥάΠϯͷcodeΛઃఆͯ͘͠ ͍ͩ͞ɻࠓճͷྫͰ͸PluginManagerΫϥεͷinstallϝιου ͕࣮ߦ͞Ε·͢ɻ
18. 3.ϓϥάΠϯࢀߟ
19. ։ൃ࣌ͷࢀߟϖʔδ • ϓϥάΠϯ࢓༷ॻ
 http://downloads.ec-cube.net/src/manual/v3/plugin.pdf • ৽ϓϥάΠϯػߏͷઆ໌
 http://qiita.com/chihiro-adachi/items/6318642120f67faedf0b • αϯϓϧϓϥάΠϯ
 https://github.com/k-yamamura/eccube3-new-sample-plugin • ϓϥάΠϯδΣωϨʔλ
 http://www.ec-cube.net/products/detail.php?product_id=1022