[ADD-ON] JumpSeat Travel Module

[DisposableHero 40]

View File At Downloads Section

JumpSeat Travel Module

---

Module enables JumpSeat Travel for pilots, the frontend is a widget which can be placed anywhere you wish. There are no settings for the module itself, no database tables are there either. All settings/adjustments are done via widget.

 

Module is compatible with dev builds released after 20.MAR.2021

 

***** Installation Steps 

 

S1. Upload contents of the module (or pull via GitHub) to your root/modules/JumpSeat folder.

Go to admin section and enable the module, that's all.
On some servers, after enabling/disabling modules an app cache cleaning process may be necessary (check admin/maintenance).

 

***** Usage

 

S2. Place the widget as described below, anywhere protected with login/auth would be good. 
    (Dashboard, User Profile or any other password protected area 'cause widget will not be visible without login)

   

@widget('Modules\JumpSeat\Widgets\JumpSeat')

 

S3. (Optional) Adjust the options you want to use for JumpSeat Travel.

   

@widget('Modules\JumpSeat\Widgets\JumpSeat', ['price' => 'auto', 'base' => 0.20])

 

• ['price' => 'free'] (this is the default option) no ticket costs, travel is free of charge.
• ['price' => 50] (or any number you wish except 0) ticket will cost 50 $/Eur (currency of your phpvms settings).
• ['price' => 'auto'] ticket price will be calculated according to the great circle distance between the airports travelled.
• ['price' => 'auto', 'base' => 0.25] this will force the auto price system to use 0.25 cents per nm.

 

Please be carefull with the base price definition, anything above 0.50 will make your jumpseats really expensive 'cause it gots multiplied by the distance directly.

 

Real world companies normally offer reduced/discounted prices to "ID Travel" partners (other company workers), though they are mostly lower than their base economy ticket prices and offer services between economy and business class, 0.13 or 0.15 cents per nm are good start/default values to have.

 

S4. (Optional) If you want to edit views you can copy the blade files to your template as described below.

 

source : phpvms root\modules\JumpSeat\Resources\views\jumpseat.blade.php
target : phpvms root\resources\views\layouts\Your_Theme_Folder\modules\JumpSeat\jumpseat.blade.php

 

***** IMPORTANT UPDATE PROCEDURE FOR OLD VERSION USERS *****

 

Please disable the module from Module Manager (check admin section) then delete all files related to JumpSeat Module before installing this new version, not removing old files may cause problems during usage. Re-enable after uploading new version.

 

phpvms root\modules\JumpSeat (yes, delete complete folder)

phpvms root\app\Widgets\JumpSeat.php
phpvms root\resources\views\layouts\default\widgets\jumpseat.blade.php
phpvms root\resources\views\layouts\Your Theme Folder\widgets\jumpseat.blade.php

Thanks to Nabeel, Andreas and translators (ARV187, Maco & GAE074) for their support during the development of this module.

Please check/follow GitHub for possible updates and/or improvements.

 

Enjoy,
B.Fatih KOZ
"Disposable Hero"
https://github.com/FatihKoz

---

• Submitter
  DisposableHero
• Submitted
  02/08/21
• Category
  Add-ons

 

Edited March 29 by DisposableHero
New version instructions

[IFL442 0]

Is it possible to change the tool so that if necessary an aircraft can also be moved, because the user does not know where an aircraft is available. 

[DisposableHero 40]

No unless you edit the module on your own and add aircraft to the process (which in my opinion will be really un-realistic) ... This is a module for pilots to change their locations, not a tool for va admins/managers to let their aircraft jump from a to b without flights.

 

For listing your aircraft locations, there are some solutions ... There is a widget i developed (and available here for free) which gives you the counts of aircrafts at airports. If you want to give your pilots some clues you can use it (though it does not provide types or registrations, just gives an airport and a count of total aircrafts parked there). Or you can develop your own module for your fleet locations or find a module for listing until phpvms default core offers some solutions (if it offers of course).

 

Safe flights

Edited March 8 by FatihKoz

[jftejeiro 5]

I installed the module but cannot access it. There is no button or link.
Can you help me?

How to place the menu to access the main page

Edited April 2 by jftejeiro

[DisposableHero 40]

 

Quote

the frontend is a widget which can be placed anywhere you wish. 

As written in instructions (above), the module has no link or a button. It uses a widget, which can be placed anywhere you wish. (my suggestion is using dashboard/index for this, but you are free to choose your location)

 

How can I help you anymore I do not know. Sorry but I can not edit files on your server or choose a widget location for you

 

If you are new to v7 and laravel theme logic, please check the docs ( docs.phpvms.net ), they will give you the basic idea where to find files etc.

[jftejeiro 5]

The truth is that I am lost. I don't understand this from widgets.
In the Module manager, the View Fronted Module button doesn't get me anywhere.
I don't know where I have to put the widget
@ widget ('Modules \ JumpSeat \ Widgets \ JumpSeat', ['price' => 'auto', 'base' => 0.20])
I don't control this. I have a lot to read

 

[DisposableHero 40]

We may have a language barrier here, I think i clearly wrote that the module has no links or pages or etc, the frontend is a widget ... So clicking `View Frontend` button of course will not get you anywhere  And clicking Admin button will give you nothing too (except some text and info).

 

As i wrote in module description and in the reply just above your post, selecting a location and adding the widget there is up to you ... ( I still do suggest using dashboard ) 

 

But again, if you really do not know where the dashboard is or how to edit views/pages in phpvms v7, you really need to read more  

[jftejeiro 5]

I perfectly understood what he told me. I understood it before and now.
What happens is that I don't know how to do what you tell me, that's why I say I have to read more. Thank you very much for your time.

[Dougjuk 15]

Hi,

 

Coming from a non skilled person in this stuff all I had to do was edit the page I wanted the jumpseat to be in and add the line that calls the widget.  (As per the read me)  It was a trial an error to get the correct line but was easy enough.

 

In my case I added it to the dashboard, so it went into the index.blade.php file located in the dashboard section of the theme I was using.

 

But I keep telling people don't bother adding it to the default theme it will just get overwritten on an update.

 

Regards

Dough

[Dougjuk 15]

On 4/4/2021 at 12:34 AM, jftejeiro said:

I perfectly understood what he told me. I understood it before and now.
What happens is that I don't know how to do what you tell me, that's why I say I have to read more. Thank you very much for your time.

 

 

I got you message, thought I would reply on here so others can see.

 

1. Make sure you upload the module to the right place.   It should go into the phpvms/modules/ folders so it looks like image 1 

 

2. Go into your admin page for modules and you should see a line at the bottom asking if you want to activate the module.  Once activated it joins the list above, just like image 2 

 

3. Before leaving admin go to the maintenance and clear the cache in fact press all 3.      Like image 3

 

4. Now if you follow the instruction you just need to call it to one of you pages as described in the instructions.  Mine is in the dashboard of the disposable theme.  So it in in index.blade.php inside the dashboard folder.  I have mine set to auto but you can see the entry in the last image.  

Edited April 5 by Dougjuk

[jftejeiro 5]

1 hour ago, Dougjuk said:

 

 

I got you message, thought I would reply on here so others can see.

 

1. Make sure you upload the module to the right place.   It should go into the phpvms/modules/ folders so it looks like image 1 

 

2. Go into your admin page for modules and you should see a line at the bottom asking if you want to activate the module.  Once activated it joins the list above, just like image 2 

 

3. Before leaving admin go to the maintenance and clear the cache in fact press all 3.      Like image 3

 

4. Now if you follow the instruction you just need to call it to one of you pages as described in the instructions.  Mine is in the dashboard of the disposable theme.  So it in in index.blade.php inside the dashboard folder.  I have mine set to auto but you can see the entry in the last image.  

 

 

Thank you very much, you are very kind.
I was going crazy because I thought I was doing it right but it wasn't going well.

In order not to make mistakes, what I did was copy the example line that the program brings, so as not to make an error when writing the code.

The problem that if you put the code like this:
@ widget ('Modules \ JumpSeat \ Widgets \ JumpSeat', ['price' => 'auto']) the widget is not working.

But if you put the code like this:
@widget ('Modules \ JumpSeat \ Widgets \ JumpSeat', ['price' => 'auto'])
the widget does work.
For those of us who don't know about code, we can go crazy, we don't know anymore.

The small difference between it working and not working is in the blank "  " after the @
Putting "@widget" is not the same as putting "@ widget", that makes a difference.
Thanks a lot. A picture is worth a thousand words.
Greetings

 

 

Edited April 5 by jftejeiro

[Dougjuk 15]

fantastic, glad I could help, I too am not very good at this stuff.

 

regards

 

Doug

[DisposableHero 40]

Glad you solved it ...

 

Correct usage example was in the readme and the description posted here at the forum.

 

Safe flights,

[DisposableHero 40]

On 4/5/2021 at 1:42 PM, jftejeiro said:

 

 

Thank you very much, you are very kind.
I was going crazy because I thought I was doing it right but it wasn't going well.

In order not to make mistakes, what I did was copy the example line that the program brings, so as not to make an error when writing the code.

The problem that if you put the code like this:
@ widget ('Modules \ JumpSeat \ Widgets \ JumpSeat', ['price' => 'auto']) the widget is not working.

But if you put the code like this:
@widget ('Modules \ JumpSeat \ Widgets \ JumpSeat', ['price' => 'auto'])
the widget does work.
For those of us who don't know about code, we can go crazy, we don't know anymore.

The small difference between it working and not working is in the blank "  " after the @
Putting "@widget" is not the same as putting "@ widget", that makes a difference.
Thanks a lot. A picture is worth a thousand words.
Greetings

 

 

 

Just wondering, when did you downloaded the module ?

 

The screen you posted is from an admin.blade.php which changed before i released the final 1.2.0 (with language file support and corrected escape for `@widget` calls ...

 

Not a big issue but you may want to download it again, either from here or from Github. The core JumpSeat is ok but you may be missing language translations etc.

[jftejeiro 5]

The version I have downloaded is 1.2.0, but I will download it again in case there is a problem.
Thanks

[DisposableHero 40]

Not a big deal but it is strange, most probably you will only need the admin.blade.php and maybe some language files if missing any.

 

I just realized it from the screenshot you posted.

[jftejeiro 5]

How the language files are changed in the template and widgets

[DisposableHero 40]

12 hours ago, jftejeiro said:

How the language files are changed in the template and widgets

 

Admin -> settings ... Select your language 

 

If you are asking to create new language files (translations) you need to edit the files under resources\langs folder. For modules it may be different but most probably under modules\ModuleName\Resources\lang (as an example modules\JumpSeat\Resources\lang )

 

There you will see the provided langauges in folders, like en / es / fr / de with ISO country codes. Just copy one of them (en for example) and give it a new name like (it for Italian) , edit the files under newly created/coppied folder by translating every single line.

 

After saving that new file and selecting that language from admin/settings you will see your translations applied.

 

 

[DisposableHero 40]

This is the language file of JumpSeat Travel

 

return [
  // Widget Body
  'jstitle'    => 'JumpSeat Travel',
  'jsdropdown' => 'Please select your destination',
  'jsbutton'   => 'Travel',
  'iconfree'   => 'Free Travel',
  'iconfixed'  => 'Fixed Ticket Price:',
  'iconauto'   => 'Automatic Ticket Price Calculation',
  // Success Response Messages
  'successfree'  => 'JumpSeat travel completed, you are at :location now.',
  'successfixed' => 'JumpSeat travel completed, you are at :location now. Ticket price was :price',
  'successauto'  => 'JumpSeat travel completed, you are at :location now. Calculated ticket price was :price for :distance nm',
  // Error Response Messages
  'errordest'    => 'JumpSeat travel not possible without a valid destination!',
  'errorfunds'   => 'JumpSeat travel not possible, not enough funds! You need at least :price',
];

 

do not touch the left part, it is the definition  edit only the right side like

 

'jsdropdown' => 'Seleziona la tua destinazione',

 

Do NOT translate in text definitions like :price or :location , they are being populated by the code

 

`Sei alla :location adesso`,

 

Will result Sei alla LIRF adesso

 

Hope this helps to understand the logic behind it.

[jftejeiro 5]

Brilliant. I understood perfectly. Thanks

[jftejeiro 5]

😂😂

Well, in my Admin panel there is no option to change the language.
I have the version installed
version 7.0.0 dev

general
Units
acars
airports
bids
flights
simbrief
pyreps
pilots
notifications.
In none of these sections is there anything related to changing the language

[Dougjuk 15]

Thats not part of the Jumpseat module, that is the main phpVMS setup.  I don't know if you can alter the language for it.

[DisposableHero 40]

3 hours ago, jftejeiro said:

😂😂

Well, in my Admin panel there is no option to change the language.

 

edit your config.php , add two lines to app section as below

 

'locale' => env('APP_LOCALE', 'it'),
'fallback_locale' => 'en',

 

it will look like something like this when finished

 

// Overrides config/app.php
'app' => [
    'name' => 'Your VA Name',
    'url'  => 'http://Your VA URL',
    'locale' => env('APP_LOCALE', 'it'),
    'fallback_locale' => 'en',

    // When live, 'env' should be 'prod'
    'env'   => 'prod',

 

the locale setting defines the main language to be used by phpvms, fallback is the safety part ... If "it" / Italian translation is not found "en" English will be used

 

It may be defined during install, i am not sure ... But you are right, language selection is not in the admin / settings.

[jftejeiro 5]

Thanks so much for the explanation 🙂