Message-ID: <795408130.3180.1485852295352.JavaMail.confluence@ip-10-127-227-164>
Subject: Exported From Confluence
MIME-Version: 1.0
Content-Type: multipart/related;
boundary="----=_Part_3179_1074375508.1485852295352"
------=_Part_3179_1074375508.1485852295352
Content-Type: text/html; charset=UTF-8
Content-Transfer-Encoding: quoted-printable
Content-Location: file:///C:/exported.html
Migrating legacy Page field (ezflow) to eZ Studio Landing Page</=
title>
<!--[if gte mso 9]>
<xml>
<o:OfficeDocumentSettings>
<o:TargetScreenSize>1024x640</o:TargetScreenSize>
<o:PixelsPerInch>72</o:PixelsPerInch>
<o:AllowPNG/>
</o:OfficeDocumentSettings>
<w:WordDocument>
<w:View>Print</w:View>
<w:Zoom>90</w:Zoom>
<w:DoNotOptimizeForBrowser/>
</w:WordDocument>
</xml>
<![endif]-->
<style>
<!--
@page Section1 {
size: 8.5in 11.0in;
margin: 1.0in;
mso-header-margin: .5in;
mso-footer-margin: .5in;
mso-paper-source: 0;
}
td {
page-break-inside: avoid;
}
tr {
page-break-after: avoid;
}
div.Section1 {
page: Section1;
}
/* Confluence print stylesheet. Common to all themes for print medi=
a */
/* Full of !important until we improve batching for print CSS */
@media print {
#main {
padding-bottom: 1em !important; /* The default padding of 6em is to=
o much for printouts */
}
body {
font-family: Arial, Helvetica, FreeSans, sans-serif;
font-size: 10pt;
line-height: 1.2;
}
body, #full-height-container, #main, #page, #content, .has-personal-sid=
ebar #content {
background: #fff !important;
color: #000 !important;
border: 0 !important;
width: 100% !important;
height: auto !important;
min-height: auto !important;
margin: 0 !important;
padding: 0 !important;
display: block !important;
}
a, a:link, a:visited, a:focus, a:hover, a:active {
color: #000;
}
#content h1,
#content h2,
#content h3,
#content h4,
#content h5,
#content h6 {
font-family: Arial, Helvetica, FreeSans, sans-serif;
page-break-after: avoid;
}
pre {
font-family: Monaco, "Courier New", monospace;
}
#header,
.aui-header-inner,
#navigation,
#sidebar,
.sidebar,
#personal-info-sidebar,
.ia-fixed-sidebar,
.page-actions,
.navmenu,
.ajs-menu-bar,
.noprint,
.inline-control-link,
.inline-control-link a,
a.show-labels-editor,
.global-comment-actions,
.comment-actions,
.quick-comment-container,
#addcomment {
display: none !important;
}
.comment .date::before {
content: none !important; /* remove middot for print view */
}
h1.pagetitle img {
height: auto;
width: auto;
}
.print-only {
display: block;
}
#footer {
position: relative !important; /* CONF-17506 Place the footer at en=
d of the content */
margin: 0;
padding: 0;
background: none;
clear: both;
}
#poweredby {
border-top: none;
background: none;
}
#poweredby li.print-only {
display: list-item;
font-style: italic;
}
#poweredby li.noprint {
display: none;
}
/* no width controls in print */
.wiki-content .table-wrap,
.wiki-content p,
.panel .codeContent,
.panel .codeContent pre,
.image-wrap {
overflow: visible !important;
}
/* TODO - should this work? */
#children-section,
#comments-section .comment,
#comments-section .comment .comment-body,
#comments-section .comment .comment-content,
#comments-section .comment p {
page-break-inside: avoid;
}
#page-children a {
text-decoration: none;
}
/**
hide twixies
the specificity here is a hack because print styles
are getting loaded before the base styles. */
#comments-section.pageSection .section-header,
#comments-section.pageSection .section-title,
#children-section.pageSection .section-header,
#children-section.pageSection .section-title,
.children-show-hide {
padding-left: 0;
margin-left: 0;
}
.children-show-hide.icon {
display: none;
}
/* personal sidebar */
.has-personal-sidebar #content {
margin-right: 0px;
}
.has-personal-sidebar #content .pageSection {
margin-right: 0px;
}
}
-->
</style>
</head>
<body>
<h1>Migrating legacy Page field (ezflow) to eZ Studio Landing Page</h1>
<div class=3D"Section1">
<p>To move your legacy Page field / eZ Flow configuration to eZ Stu=
dio you can use a script that will aid in the migration process.</p>
<p>The script will automatically migrate only data =E2=80=93 to move c=
ustom views, layouts, blocks etc., you will have to provide their business =
logic again.</p>
<div class=3D"confluence-information-macro confluence-information-macro-war=
ning">
<span class=3D"aui-icon aui-icon-small aui-iconfont-error confluence-inform=
ation-macro-icon"></span>
<div class=3D"confluence-information-macro-body">
<p>The migration script will operate on your current database.</p>
<p>Make sure to <strong>back up your database</strong> in case of an unexpe=
cted error.</p>
</div>
</div>
<p> </p>
<p>To use the script, do the following:</p>
<div class=3D"confluence-information-macro confluence-information-macro-not=
e">
<span class=3D"aui-icon aui-icon-small aui-iconfont-warning confluence-info=
rmation-macro-icon"></span>
<div class=3D"confluence-information-macro-body">
Make a note of the paths to .ini files which define your legacy blocks. You=
will need these paths later.
</div>
</div>
<p><strong>1.</strong> Add <code>ezflow-migration-toolkit</code> to <code>c=
omposer.json</code> in your clean Studio installation.</p>
<div class=3D"code panel pdl" style=3D"border-width: 1px;">
<div class=3D"codeHeader panelHeader pdl" style=3D"border-bottom-width: 1px=
;">
<b>composer.json</b>
</div>
<div class=3D"codeContent panelContent pdl">=20
<pre class=3D"brush: php; gutter: false; theme: Eclipse" style=3D"font-size=
:12px;">"ezsystems/ezflow-migration-toolkit": "^1.0.0"</pre>=20
</div>
</div>
<p><strong>2.</strong> Add <code>ezflow-migration-toolkit</code> to <code>A=
ppKernel.php</code>.</p>
<div class=3D"code panel pdl" style=3D"border-width: 1px;">
<div class=3D"codeHeader panelHeader pdl" style=3D"border-bottom-width: 1px=
;">
<b>AppKernel.php</b>
</div>
<div class=3D"codeContent panelContent pdl">=20
<pre class=3D"brush: php; gutter: false; theme: Eclipse" style=3D"font-size=
:12px;">new EzSystems\EzFlowMigrationToolkitBundle\EzSystemsEzFlowMigration=
ToolkitBundle()</pre>=20
</div>
</div>
<p><strong>3.</strong> Clear cache.</p>
<div class=3D"code panel pdl" style=3D"border-width: 1px;">
<div class=3D"codeContent panelContent pdl">=20
<pre class=3D"brush: php; gutter: false; theme: Eclipse" style=3D"font-size=
:12px;">app/console cache:clear</pre>=20
</div>
</div>
<p><strong>4.</strong> Run the script with the following parameters:</p>
<ul>
<li>absolute path of your legacy application</li>
<li>list of .ini files which define your legacy blocks</li>
</ul>
<div class=3D"code panel pdl" style=3D"border-width: 1px;">
<div class=3D"codeHeader panelHeader pdl" style=3D"border-bottom-width: 1px=
;">
<b>Script command</b>
</div>
<div class=3D"codeContent panelContent pdl">=20
<pre class=3D"brush: php; gutter: false; theme: Eclipse" style=3D"font-size=
:12px;">app/console ezflow:migrate <legacy path> =E2=80=94ini=3D<b=
lock definitions> [=E2=80=94ini=3D<another block definition> ...]<=
/pre>=20
</div>
</div>
<div class=3D"code panel pdl" style=3D"border-width: 1px;">
<div class=3D"codeHeader panelHeader pdl" style=3D"border-bottom-width: 1px=
;">
<b>Example of the migration script command</b>
</div>
<div class=3D"codeContent panelContent pdl">=20
<pre class=3D"brush: php; gutter: false; theme: Eclipse" style=3D"font-size=
:12px;">app/console ezflow:migrate /var/www/legacy.application.com/ =E2=80=
=94ini=3Dextension/myapplication/settings/block.ini.append.php</pre>=20
</div>
</div>
<p><strong>5.</strong> You will be warned about the need to create a backup=
of your database. <strong>Proceed only if you are sure you have done it.</=
strong></p>
<div class=3D"confluence-information-macro has-no-icon confluence-informati=
on-macro-information">
<div class=3D"confluence-information-macro-body">
<p>A <code>MigrationBundle</code> will be generated in the <code>src/</code=
> folder.</p>
<p>You will see a report summarizing the results of the migration.</p>
</div>
</div>
<p><strong>6.</strong> Add <code>MigrationBundle</code> to <code>AppKernel.=
php</code>.</p>
<div class=3D"code panel pdl" style=3D"border-width: 1px;">
<div class=3D"codeHeader panelHeader pdl" style=3D"border-bottom-width: 1px=
;">
<b>AppKernel.php</b>
</div>
<div class=3D"codeContent panelContent pdl">=20
<pre class=3D"brush: php; gutter: false; theme: Eclipse" style=3D"font-size=
:12px;">new MigrationBundle\MigrationBundle()</pre>=20
</div>
</div>
<p><strong>7.</strong> Clear cache again.</p>
<p> </p>
<p>At this point you can already view the initial effects of the migration,=
but they will still be missing some of your custom content.</p>
<p>The <code>MigrationBundle</code> generates placeholders for layouts in t=
he form of frames with a data dump.</p>
<p>For blocks that could not be mapped to existing Landing Page blocks, it =
will also generate PHP file templates that you need to fill with your own b=
usiness logic.</p>
<p> </p>
</div>
</body>
</html>
------=_Part_3179_1074375508.1485852295352--