In dit artikel zullen we de datum
type optie in Titan Framework: hoe het werkt en welke parameters het biedt. Ontdek hoe u een datumkiezer kunt maken in een aangepast WordPress-beheerdersdashboard, een metabox of een customizer-gedeelte.
In Titan Framework is er een datum
type optie waarmee eindgebruikers de datum- en tijdinstellingen dynamisch kunnen invoeren in hun thema's. Met deze optie wordt de volledige kalender geladen en kunt u elke gewenste datum instellen. Hier is de lay-out van deze optie:
Laten we eens kijken naar de lijst met parameters die deze optie ondersteunt:
datum
type optie.datum
instellingen. Deze parameter neemt een specifiek formaat van waarden op, d.w.z.. Y-m-d
voor de datum, Hoi
voor de tijd, en Y-m-d H: i
voor zowel datum als tijd.vals
, deze optie wordt niet getoond. Het is ingesteld op waar
standaard.waar
, deze optie verschijnt. Het is ingesteld op vals
standaard.De parameters datum en tijd zijn boolean
op type, terwijl de rest van het type zijn draad
.
De datum
type optie kan binnen gemaakt worden:
Deze optie wordt gemaakt door een vergelijkbare coderoutine te volgen, ongeacht het containertype:
getInstance ()
functie.createOption ()
functie.GetOption ()
functie. Als u echter wilt weten hoe deze containers met Titan Framework worden gemaakt, kunt u de details in mijn vorige artikelen in deze serie vinden.
Eerst maak ik dit optietype aan in een beheerdersvenster.
createOption (array ('id' => 'aa_date', // De ID die wordt gebruikt om de waarde van deze optie te krijgen 'type' => 'datum', // Type optie we maken 'naam' => 'Mijn datumoptie', // Naam van de optie die wordt weergegeven in het adminpaneel 'desc' => 'Dit is onze optie', // Beschrijving van de optie die wordt weergegeven in het beheerdersvenster 'standaard' = > '2015-8-15' // Standaardwaarde));
EEN datum
type optie wordt aangemaakt in een admin paneel $ aa_panel
via de createOption ()
functie (regel # 7). Ik heb de parameters gedefinieerd id, type, naam, desc en standaard. De ID (d.w.z.. aa_date
) moet altijd uniek zijn.
U kunt zien dat de genoemde optie Mijn datumoptie bestaat in een admin panel Nette opties. De standaard datuminstelling wordt ook weergegeven in de bovenstaande schermafbeelding.
Laten we de opgeslagen optiewaarden ophalen.
getOption ('aa_date'); // Converteer de datum van de echografische waarde van de datum van de datum ('r', $ aa_date_epoch_val); // output als RFC 2822-datum - geeft lokale tijd terug - Lees voor meer informatie http://goo.gl/g9tZLi?>
In regel # 3 wordt een exemplaar verkregen via de getInstance ()
functie, die een unieke parameter vereist, bij voorkeur je themanaam (die ik heb gebruikt netjes
). De opgeslagen waarden worden opgehaald via de GetOption ()
functie in regel # 6, die de ID registreert aa_date
als een parameter en slaat de waarde op in een nieuwe variabele $ aa_date_val
.
Het laatste deel van de code drukt waarden af aan de voorkant. In de meeste gevallen kan de server ons een epoch-waarde retourneren, die we moeten converteren met behulp van PHP's datum()
functie. Het bespreken van epoch-waarden valt buiten het bestek van deze tutorial, maar u kunt hier meer over lezen.
Nu zal ik elke demodatumwaarde instellen en opslaan. Ik kies er bijvoorbeeld voor 2015/08/20
.
Laten we de uitvoer aan het front-end bekijken.
De opgeslagen datuminstelling is correct afgedrukt, met de tijd. Als de parameter voor tijd
is nu uitgeschakeld, er worden geen tijdsinstellingen weergegeven. Hoe stel je de tijd in? Ik kom daar een beetje op terug.
Nu zal ik deze optie toevoegen aan een admin tab, maar het zal beide tonen datum
en tijd
instellingen.
createOption (array ('id' => 'aa_date_in_tab1_panel2', // ID's moeten altijd uniek zijn.De ID die wordt gebruikt om de waarde van deze optie te krijgen 'type' => 'datum', // Type optie we zijn aanmaken 'naam' => 'Mijn datum optie', // Naam van de optie die getoond wordt in het admin paneel 'desc' => 'Dit is onze optie', // Beschrijving van de optie die getoond wordt in de admin paneel 'default' => '2015-8-15 00:00', // Standaardwaarde voor datum & tijd 'tijd' => true // Tijdinstellingen ingeschakeld.));
Deze keer voeg ik een toe datum
typ optie in een admin tab $ aa_tab1
. Zijn ID is aa_date_in_tab1_panel2
. Kijk naar de lijst met parameters. Het laat zien tijd
ingesteld op waar
. Dit betekent dat de tijdselectie is ingeschakeld. Let op de waarde-indeling voor standaard
, die is ingesteld voor beide datum
en tijd
.
Je kunt vinden Mijn datumoptie in Tab 1van het admin panel Nette opties 2.
Laten we de waarden ophalen.
getOption ('aa_date_in_tab1_panel2'); echo datum ('r', $ aa_date_in_tab1_panel2_val); // output als RFC 2822-datum - geeft lokale tijd terug - Lees voor meer informatie http://goo.gl/g9tZLi?>
Er is echt niets nieuws in deze code.
Stel dat mijn demodatum en tijdwaarden dat zijn 2015/09/06 en 08:45. Er is ook een Nu knop waarmee de huidige tijdwaarde met één klik wordt ingesteld.
De voorkant ziet er als volgt uit:
Laten we de code schrijven.
createOption (array ('id' => 'aa_mb_date', // ID's moeten altijd uniek zijn.De ID die wordt gebruikt om de waarde van deze optie te krijgen 'type' => 'datum', // Type optie we zijn aanmaken 'naam' => 'Selecteer Tijd Instellingen', // Naam van de optie die getoond wordt 'desc' => 'Dit is onze optie', // Beschrijving van de optie die 'default' => 'getoond wordt 00:00 ', // Standaardwaarde voor tijd' datum '=> false, // Datuminstellingen uitgeschakeld.' Time '=> true // Datuminstellingen ingeschakeld.));
De createOption ()
functie voegt een toe datum
type optie in een metabox $ aa_metbox
(regel # 5). Maar deze code wordt alleen weergegeven tijd
instellingen omdat het datum
is ingesteld op false. Dat is waarom ik de. Heb veranderd naam en standaard waarden van deze optie dienovereenkomstig.
Bovenstaande schermafbeelding toont een tijdkiezer met de naam Selecteer Tijdinstellingenin een metabox. Dit verschijnt op alle pagina's en na bewerkingsschermen.
Laten we de opgeslagen tijdwaarden ophalen.
getOption ('aa_mb_date', get_the_ID ()); echo datum ('r', $ aa_mb_time_epoch_val); // output als RFC 2822-datum - geeft lokale tijd terug - Lees voor meer informatie http://goo.gl/g9tZLi?>
Ik heb zojuist de waarde van tijd opgehaald en deze vervolgens geconverteerd met de datum()
functie.
Mijn demotijdwaarde is 13: 03.
De uitvoer wordt als volgt afgedrukt:
Uiteindelijk zal ik deze optie toevoegen in een themaaanpassingsgedeelte.
createOption (array ('id' => 'aa_sec_date', // ID's moeten altijd uniek zijn.De ID die wordt gebruikt om de waarde van deze optie te krijgen 'type' => 'datum', // Type optie we zijn aanmaken 'naam' => 'Selecteer datum / tijd instellingen', // Naam van de optie die getoond wordt 'desc' => 'Dit is onze optie', // Beschrijving van de optie die 'standaard' wordt getoond = > '2015-08-01', // Standaardwaarde voor datum en tijd 'datum' => true, // Datuminstellingen ingeschakeld. 'Time' => true // Tijdinstellingen ingeschakeld.));
Ten slotte heb ik deze optie toegevoegd volgens dezelfde procedure in een themaaanpassingsgedeelte.
Het screenshot laat het duidelijk zien.
Laten we de opgeslagen optiewaarden ophalen.
getOption ('aa_sec_date'); ?>Waarde van datum / tijd is
Ik zal de opgeslagen waarden in de header.php
het dossier. Dus, krijg eerst een instantie en registreer de unieke ID in de GetOption ()
functie. Maak vervolgens een div en print de uitvoer van de variabele $ aa_sec_date_val
via de datum()
functie (regel # 13).
Hier is een screenshot van de veranderingen die plaatsvinden.
Op deze manier kunt u dynamische datum- en tijdinstellingen toevoegen aan uw WordPress-thema's en -plug-ins. Deze optie kan handig zijn wanneer u wilt dat de eindgebruiker de datum en tijd invoert om welke reden dan ook.
Ik was bijvoorbeeld bezig met het opbouwen van dit WordPress-thema, waar ik een aangepast berichttype wilde toevoegen (via een plug-in). Op dat moment had ik de mogelijkheid om een van de meest gebruikte Event-plug-ins toe te voegen of zelf een nette kleine plug-in te coderen.
Dus in plaats van mijn klant te voorzien van een gebeurtenis-plug-in die mogelijk op de cockpit van een vliegtuig leek, heb ik Titan Framework gebruikt. Ik gebruikte de datum
typ optie twee keer in twee verschillende metaboxen voor afspraakdatums.
Integreer deze optie in uw project en verminder de last van het schrijven van lange code. In mijn volgende artikel zullen we de radio-
type optie in Titan Framework.
Heb je nog vragen? Plaats ze in de reacties hieronder of neem contact op met Twitter.